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Palmari e Smartphone ecco come programmarli! 
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Progetta subito software per dispositivi 
che stanno nel palmo di una mano 
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TEORIA Diversi sistemi operativi 
per diverse periferiche, quali 
le differenze? 

STRUMENTI II Compact .NET 
Framework, installiamolo 
e usiamolo da Visual Studio 



TECNICA Display piccolissimi 
e dotazioni ridotte. Adattiamo 
le nostre applicazioni 

PRATICA Gestiamo gli ordini 
verso l'azienda con il Pocket PC 
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DATABASE MYSQL 

ANCORA PIÙ VELOCI 

Siti web lenti? ecco le tecniche per capire dove le tue query si 
"inceppano" ed i consigli per stare sempre al top delle prestazioni 




CASI DI STUDIO: JAVA 



PAGAMENTI ONLINE 

Scegliamo la banca e creiamo un'applicazione 
con tanto di pos elettronico. Un caso concreto 



SQL SERVER 2005 



STORED PROCEDURE 

Creiamole direttamente in Visual Studio 
e usiamole come DLL nel database 



JAVA 



LOGIN SICURO 

Sviluppiamo un Web Services per gestire i "Captcha 1 
i codici grafici di confronto per il web 



VISUAL BASIC 



IL WEB E SERVITO 

Impariamo a usare gli Active 
Document. Form speciali che 
"vivono" nel browser! 



NON PERDERE 
MAI IL CODICE! 

Utilizza gli "Snippets" e crea 
piccoli template di procedure 
riutilizzabili quando servono 

CREA LE CLASSI 
AL VOLO 

Impara come funzionano 
i "Build Compilers" e sviluppa 
pagine con estensioni mai viste 

SOFTWARE 
DOCUMENTATO 

Scrivi applicazioni 
autoesplicative, per utenti 
che non devono chiedere mai! 



• IN PIÙ LA VIDEOGUIDA NEL CD 



SCRIVILO 
SUL MURO 

Sviluppiamo un GuestBook 
molto particolare con Spring 
e il pattern MVC 

DA SQL 
AD OGGETTI 

Facciamolo con Cayenne, 
il tool con interfaccia grafica 
che rende tutto semplice 

FILTRI GRAFICI 

Metti un Photoshop nella tua 
applicazione. Con una libreria 
semplice e OpenSource 
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Questo mese su ioProgrammo 



Interoperabilità 



La parola chiave per il futuro dello sviluppo sem- 
bra essere "Interoperabilità". In un mondo in cui 
convivono architetture, servizi e sistemi differenti 
appare logico che l'unica strada affinché il mondo 
"interconnesso" possa continuare a essere utile per 
i propri utenti è quello di trovare un modo affinché 
tutti gli attori che lo compongono riescano a comu- 
nicare fra loro. 

Perciò, Microsoft, Sun, IBM, Oracle e più in basso 
l'intera community OpenSource spingono per tro- 
vare un terreno di intesa comune. Così nasce il con- 
sorzio per l'Open Document, così si discute su 
Soap, così si parla di formati. Ma esattamente qual è 
la fotografia della situazione? A ben guardare siamo 
ben lontani da un qualunque accordo. Tutte le varie 
aziende spingono nella direzione che ritengono più 
opportuna ed è scontro su tutto. Avete mai provato 
a sviluppare un Web Services un po' più complesso 
del solito e magari ad applicarvi delle politiche di 
security? Se lo avete fatto avrete già scoperto che la 
tanto mitizzata possibilità di far consumare a un 
client scritto in un qualunque linguaggio un web 
services scritto in un altro diventa un'operazione 



non banale. E vogliamo parlare dei formati? Open 
Document è attualmente un terreno di scontro 
durissimo la dove le diverse implementazioni pro- 
pongono modelli che non possono assumersi in 
nessun caso l'onere di standard. Cosa possiamo fare 
noi programmatori? Proprio noi che siamo sempre 
alla ricerca estrema della tecnica più innovativa, 
possiamo solo e solamente in questo caso, utilizzare 
quella meno innovativa ma più consolidata. Perciò 
se non vogliamo ritrovarci a breve termine con un 
mondo di software completamente inutilizzabile se 
non per la piattaforma su cui è stato implementato 
è il caso di cominciare a fare un passo indietro e per 
una volta dettare noi al mercato quali sono gli stan- 
dard che intendiamo adottare. E noi sappiamo che 
quelli più comodi da adottare sono quelli che facili- 
tano il nostro lavoro. Per una volta dunque, faccia- 
mo sentire anche la nostra voce. Suggerimenti, 
email, considerazioni sono ben accette all'indirizzo 
redazione@ioprogmmmo.it, saremo ben lieti di dare 
visibilità al vostro lavoro. 

Fabio Farnesi ffarnesi@edmaster. it 




All'inizio di ogni articolo, troverete un simbolo 
che indicherà la presenza di codice e/o software 
allegato, che saranno presenti sia sul CD (nella 
posizione di sempre \soft\codice\ e \soft\tools\) 
sia sul Web, all'indirizzo 
http://cdrom.ioprogrammo.it. 



WINDOWS 



BB9 MOBILE 



in edicola e nei punti vendita autorizzati, facendo fede il timbro 



Inviare il CD-Rom difettoso in busta chiusa a: 
"aster - Servizio Clienti - Via C. Correnti, 1 - 20123 1\ 



Assistenza tecnica: ioprogrammo@edmaster.it 

i: Arti Grafiche Boccia S.p.a. Via Tiberio Felice, 7 ! 

Stampa CD-Rom: Neotek S.r.l. - C.da Imperatore - Bisignano (CS) 

Distributore esclusivo per l'Italia: Parrini & C S.p.A. 

Via Vitorchiano, 81 - Roma 

Finito di stampare nel mese di Giugno 2006 
Nessuna parte della rivista può essere in alcun modo riprodotta senza 



anche se non pubblicati, non si restituiscono. Edizioni Master non sarà 
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Progetta subito software 
per dispositivi che stanno 
nel palmo di una mano 

• TEORIA: diversi sistemi operativi 
per diverse periferiche, 
quali le differenze 
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• STRUMENTI: Il Compact .net Framework, 
istalliamolo e usiamolo da Visual Studio 



• TECNICA: Display piccolissimi 
e dotazioni ridotte . 
Adattiamo le nostre applicazioni 

• PRATICA: Gestiamo gli ordini verso 
l'azienda con il Pocket PC 
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Questo mese su ioProgrammo 



DATABASE MYSQL ANCORA PIÙ VELOCI 

Siti Web lenti? ecco le tecniche per capire dove le tue query si 
"inceppano" ed i consigli per stare sempre al top delle prestazioni 

pag. 62 



IOPROGRAMMO WEB 



E-Commerce facile in Java 

pag. 22 

In questo aricolo mostriamo come utilizzare 
uno dei servizi di pos elettronico più famosi 
eutilizzati in Italia: Easynolo sviluppato da 
banca sella, scopriremo che è sufficiente 
una manciata di codice e qualche api per 
rendere tutto semplice 

Classi al volo con il codice dinamico. 
pag. 28 

La versione 2.0 di .NET è talmente personal- 
izzabile che l'intero compilatore è esposto 
in classi. Questa caratteristica può essere 
sfruttata per far gestire a classi speciali file 
particolari 

Login protetto con immagini captcha 
pag. 32 

Vi è mai capitato di dover riportare il testo 
rappresentato in un'immagine all'interno di 
una form, per poter effettuare la regis- 
trazione a un sito Web? ecco come potete 
implementare questa funzione nei vostri siti 



influenzare decisamente i tempi di risposta 
del server. Ma quali sono i parametri su cui 
basarci per scrivere query efficienti? Ecco 
come ottenere informazioni utili per ottimiz- 
zare le interrogazioni 



SISTEMA 



Comunicazioni 
basate sui contratti 

pag. 36 

Sviluppare servizi significa 
pensare non solo alla 
propria piattaforma di 
sviluppo, ma guardare a 
concetti come standard e 
interoperabilità al fine di 
consentire l'utilizzo 
dell'applicazione con 
qualunque tecnologia 



DATABASE 



Stored procedure in codice mana- 
ged pag. 54 

Una delle novità portate dall'accoppiata 
.NET 2.0 e SQL server 2005 è costituita 
dalla possibilità di scrivere metodi 
direttamente dal proprio linguaggio 
preferito per poi utilizzarli dall'interno 
del DB. Vediamo come funziona... 

Ottimizzazione di MYSQL pag. 62 

Il modo in cui una query viene scritta può 



VISUAL BASIC 



applicazioni Web 
con gli activex 

pag. 74 

Ecco le tecniche da usare per 
sviluppare siti Web dinamici 
utilizzando visual basic 



SISTEMA 



Frammenti di saggezza pag. 50 

Capita spesso di voler riutilizzare uno 
spezzone di codice prodotto in 
precedenza, all'interno di un nuovo 
progetto, dove cercarlo? Con gli 
"Snippet" di visual studio è possibile 
mantenere un archivio molto particolare 

Persistenza dei dati con Cayenne 
pag. 80 

Numerosi framework orm permettono di 
creare oggetti a partire da basi di dati e 
viceversa. Cayenne ha delle 
caratteristiche estremamente 
interessanti e utilizzabili sia per progetti 
amatoriali che professionali 



RUBRICHE 



Gli allegati di ioProgrammo 

// software in allegato alla rivista 



pag. 6 



Il libro di ioProgrammo pag. 7 

// contenuto del libro in allegato alla rivista 

News pag. 12 

Le più importanti novità del mondo 
della programmazione 

ioProgrammo by Example pag. 29 

4 problemi risolti con gli esempi di codice rapido 
da copiare e incollare per tutti i linguaggi 

Software pag. 106 

/ contenuti del CD allegato ad ioProgrammo. 
Corredati spesso di tutoria! e guida all'uso 



Scrivilo sul muro con spring MVC 
pag. 86 

Impariamo come costruire applicazioni 
perfettamentemanutenibili e con un alto 
grado di disaccoppiamento fra codici e 
layout. 

Creare l'help di un'applicazione 
pag. 94 

// framework .Net fornisce le classi 
necessarie ad emplementare sistemi di 
help on-line per le applicazioni Windows 
form. 

Filtri grafici in java pag. 100 

Questo articolo illustra come caricare 
un'immagine, visualizzarla in una 
finestra e applicarle diversi filtri per 
ottenere effetti grafici interessanti 
come marmo, olio o cristallizzazione 



ioProgrammo by EXAMPLE 



Come posso sapere se una connessioine atti- 
va? 42 

Come posso accedere al registro di sistema? 

43 

Come posso fare l'upload di un file tramite 

Web? 44 

Come posso aggiungere un suono ad un 

bottone in Excel? 46 

Come posso evidenziare la cella attiva di 

Excel? 47 

Che cosa è Ruby? 48 



QUALCHE CONSIGLIO UTILE 

I nostri articoli si sforzano di essere 
comprensibili a tutti coloro che ci 
seguono. Nel caso in cui abbiate 
difficoltà nel comprendere esattamente 
il senso di una spiegazione tecnica, è 
utile aprire il codice allegato all'articolo 
e seguire passo passo quanto viene 
spiegato tenendo d'occhio l'intero 
progetto. Spesso per questioni di spazio 
non possiamo inserire il codice nella 
sua interezza nel corpo dell'articolo. Ci 
limitiamo a inserire le parti necessarie 
alla stretta comprensione della tecnica. 
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Le versioni di ioProgrammo 
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RIVISTA + CD-ROM 

in edicola 







Gli indispensabili per usare subito 
il DB più amato dai Web Developer 

MYSQL 5.0.21 

La nuova versione del Database 

MYSQL ADMINISTRATOR 1.1.9 

Amministra il server in un click 

MYSQL COIXIIUECTOR 

Per connettere il Database alle tue applicazioni .NET, 
Java, J2EE,PHPetc... 

MYSQL QUERY BROWSER 

Naviga agevolmente fra le tabelle ed esegui query 
da un'interfaccia grafica comoda ed evoluta 

MYSQL MIGRATlOm TOOLKIT 

Per migrare senza problemi da Access, SQL Server, 
Oracle o altri.... 



Prodotti del mese 



Spring 1.2.8 

Il framework che II racchiude tutti 

In questo numero lo utilizziamo per 
costruire un guestbook piuttosto 
particolare. Nell'articolo del bravo 
Ivan Venuti si mostra come imple- 
mentare il pattern MVC con Spring. 
Si tratta di un framework che sta 
ottenendo un grande successo, per 
due motivi fondamentali. Prima di 
tutto raccoglie sotto un unico cap- 
pello una serie di tecnologie già 
esistenti, donandogli però una 
certa interoperabilità e una forma 
omogenea. Secondo, implementa 
perfettamente il pattern Inversion 
Of Control che consente un alto 
grado di disaccoppiamento tra le 
classi di modo che la modifica di 
una non cambi il comportamento di 
molte altre. Si tratta di un pattern 
molto interessante, per quanto sia 
investito di una certa complessità. 
Tuttavia non mancheremo di sup- 
portarvi nello sviluppo. 

[pag.106] 
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Ruby 1.8.2 

Il nuovo che avanza 

E' così quest'anno il premio 
come miglior prodotto 
dell'anno va a RubyOnRail un 
framework basato su Ruby. 
Quando qualche anno fa 
questo linguaggio fece la sua 
comparsa sul mercato, nessuno 
gli diede molto credito. Ad 
oggi si presenta come un 
linguaggio di scripting 
eccezionale che condensa in 
un'unica soluzione un modello 
ad oggetti completo, una curva 
di apprendimento che rasenta 
quasi lo zero assoluto, un alta 
integrazione con gli oggetti 
com di Windows, e altre 
elementi ancora... per creare 
un web services completo sono 
sufficienti due righe. In questo 
numero mostriamo come 
creare grafici animati in excel 
utilizzando appunto Ruby 

[pag.106] 



Ruby on Rails 

Il framework vincitore del premio 
"best tool" del 2006 

Chi lo avrebbe mai detto che un 
framework basato su Ruby avreb- 
be vinto un premio così prestigio- 
so? Ed invece ad anni di distanza 
dalla presentazione di Ruby, ecco 
arrivare un premio che lo consa- 
cra fra i linguaggi più interessan- 
ti della rete. Ruby On Rail è un fra- 
mework per lo sviluppo di applica- 
zioni Web, solide e affidabili. So- 
prattutto la bassa curva di appren- 
dimento di Ruby e l'ottima pro- 
gettazione del framework ne fan- 
no un'accoppiata molto interes- 
sante per lo sviluppo di applica- 
zioni Web. Proprio per questi mo- 
tivi Ruby On Rail si presenta come 
uno strumento da apprendere. Cer- 
tamente lo sforzo iniziale non sa- 
ranno elevati, al contrario la ve- 
locità di sviluppo ne trarrà enor- 
mi benefici 

[pag.107] 
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YetAnotherForum 
1.0.1 

Ancora un altro forum! 

Il gioco di parole si presta bene 
per marcare la vocazione 
OpenSource di questo progetto. 
Di fatto, tipicamente questo 
genere di gioco di parole viene 
applicato proprio a software 
OpenSource. YetAnotherForum è 
un forum scritto interamente in 
.NET. Il progetto è piuttosto 
ambizioso e si pone sulla scia di 
progetti ben più noti quali 
phpBB. Tuttavia è importante 
notare oltre alle qualità intrinse- 
che di questo forum che sono 
veramente eccellenti, quanto 
anche in ambienti .NET si stia 
cominciando a diffondere il con- 
cetto di OpenSource. Siamo con- 
vinti vedremo yetanotherforum 
in versioni riviste e migliorate 
proprio grazie all'apporto della 
community. 

[pag.107] 
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Progetta subito *_. 

che stanno nel palmo di l 

TEORIA Diversi sistemi operativi 
per diverte periferiche, quali 
le differenze? 

STRUMEUm II Compact .NET 
FrameworX installiamolo 
e usiamolo da. Visual tturfb 

TECNICA Display piccolissimi 
e dotazioni ridotte- Adattiamo 
le noUre applicazioni 
PRATICA Cestiamo gì i «nini 
V*r» I azienda con il Pocket PC 
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I contenuti del libra 



Imparare C# 



Oggetti, classi, polimorfismo. Si tratta dei 
concetti base che rendono la programmazione 
moderna affascinante e al contempo 
commisurata alle esigenze di una società che 
necessità sempre più di "rapidità". Ma quali sono i 
linguaggi che più di altri interpretano in modo 
ottimale questi concetti? C# sicuramente è uno di 
questi. Nato in stretta congiunzione alla tecnologia 
.NET non solo ne eredita tutti i vantaggi ma vi 
accoppia una sintassi e una semantica che sono 
propri di un linguaggio evoluto e perfettamente 
aderente alle logiche richieste ad un moderno 
linguaggio ad oggetti. Michele Locuratolo con un 
linguaggio semplice e un'informazione sempre 
precisa ci conduce dalle basi fino alla trattazione di 
elementi complessi che possono essere utili anche 
ai programmatori più esperti 



IL LINGUAGGIO PER I 
PROGRAMMATORI 
PROFESSIONISTI E PER CHI 
ASPIRA A DIVENTARLO 

• Elementi del linguaggio 

• Classi ed oggetti 

• Array indici e collections 

• Novità di C# 2.0 
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I contenuti multimediali 



GLI ALLEGATI DI IOPROGRAMMO 



t Applicazioni sicure 



L'informatica moderna ha 
portato alla ribalta alcuni 
temi che solo fino a qualche 
tempo fa sembravano esistere 
solo in uno scenario da fanta- 
scienza. Oggi un programma- 
tore deve tenere in conto la 
necessità di sviluppare appli- 
cazioni sicure. 

In queste aree Microsoft agi- 
sce con un triplice impegno. 
Dal punto di vista del produt- 
tore di applicazioni, dal punto 
di vista del produttore del 
sistema operativo, dal punto 
di vista di chi mette a disposi- 
zione framework evoluti per la 
scrittura di applicazioni. In 
questa serie di tre Webcast 



MSDN vengono illustrate 
alcune delle principali tecni- 
che di sicurezza. Si parte da 
una descrizione dei meccani- 
smi di protezione offerti dal 
kernel, per poi passare ad 
approfondire come il sistema 
operativo gestisce la sicurezza 
per i servizi e per gli utenti che 
li eseguono, terminando con 
la presentazione delle politi- 
che da adottare per la riduzio- 
ne dei privilegi assegnati agli 
utenti. Nonostante la sicurez- 
za del sistema, non dimenti- 
chiamoci, però, che buona 
parte dei bug di sicurezza 
dipendono da come noi scri- 
viamo le applicazioni. 



I VIDEOCORSI PER PROGRAMMARE SERIE 

3 WEBCAST 

«^UFFICIALI MICROSOFT 

MSimm GRATIS NEL CD "I CORSI DI FORMAZIONE" 
DA SEGUIRE COMODAMENTE SUL PC ISd^ 




Windows: la sicurezza inizia 
dal kernel 

Il processo di logon e la sicurezza 
per l'utente interattivo e per i servizi 

La riduzione dei privilegi 



INFORMAZIONI SU MSDN WEBCAST 

http://www.microsoft.it/msdn/webcast_msdn 
http://forum.ioprogrammo.it 



FAQ 



Cosa sono i Webcast MSDN? 

MSDN propone agli sviluppatori una serie di eventi gratui- 
ti online e interattivi, che approfondiscono le principali 
tematiche relative allo sviluppo di applicazioni su tecnolo- 
gia Microsoft. Questa serie di "corsi" sono noti con il 
nome di Webcast MSDN. 

Come è composto tipicamente 
un Webcast? 

Normalmente viene presentata una serie di slide commen- 
tate da un esperto di tecnologie Microsoft. A supporto 
di queste presentazioni spesso vengono realizzate 
delle demo in presa diretta che mostrano dal vivo come 
usare le tecnologie oggetto del Webcast 

Come mai nei webcast allegati 
alla rivista si parla di chat e 
di altri strumenti interattivi? 

La natura dei Webcast è quella di essere seguiti online e in 
tempo reale. Durante queste presentazioni in diretta ven- 
gono utilizzati strumenti molto simili a quelli della forma- 
zione a distanza. E' possibile porre domande in presa diret- 
ta al relatore oppure partecipare a sondaggi che vengono 
proposti. In questo modo gli sviluppatori possono aggior- 
narsi e approfondire i temi di loro interesse con maggiore 
efficacia. I Webcast riprodotti nel CD di ioProgrammo, pur 
non perdendo nessun contenuto informativo, per la natura 



asincrona del supporto non possono godere dell'interazione 
diretta con il relatore. 

Come mai trovo i WebCast 
su ioProgrammo 

Come sempre ioProgrammo cerca di fornire un servizio ai 
programmatori italiani. Abbiamo pensato che poter usufruire 
dei Webcast MSDN direttamente da un CD rappresentasse un 
ottimo modo di formarsi comodamente a casa e nei tempi desi- 
derati. Lo scopo tanto di ioProgrammo, quanto di Microsoft è 
infatti quello di supportare la comunità dei programmatori ita- 
liani con la più ampia gamma di strumenti di formazione e 
aggiornamento. 

Su ioProgrammo troverò 
tutti Webcast MSDN? 

Ne troverai sicuramente una buona parte. Direttamente sul 
sito MSDN potrai consultare il calendario dei prossimi 
webcast a cui iscriverti per seguirli in diretta oppure con- 
sultare l'archivio delle registrazioni di quelli già realizzati. 
L'indirizzo per saperne di più è 

http://www.microsoft.it/msdn/webcast msdn, segnalo nel 
tuo bookmark, non può mancare! 

L'iniziativa sarà ripetuta sui prossimi 
numeri? 

Sicuramente sì, alla prossima. 
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JAVA FA GIRARE 
VISUAL BASIC 

on si tratta di un paradosso, ma del 
progetto Visual Basic for the Java 
Platform , presentato anche esso 
durante la scorsa JavaOne. Lo scopo è 
semplice: consentire ad applicazioni 
scritte in VB di girare tramite la piat- 
taforma Java. Per certi versi Java riper- 
corre la strada effettuata da .NET, 
ovvero metterà a disposizione un com- 
pilatore che consentirà di ottenere un 
Byte Code Java a partire da sorgenti 
Visual Basic. Ora, se si pensa che Java 
già molto prima di .NET aveva nelle 
corde questo tipo di possibilità, ci si 
accorge di quanto tempo abbiano 
perso i progettisti di Sun o forse di 
quanto lungimiranti siano stati quelli 
di Microsoft. Resta il fatto che .NET 
proprio grazie alla possibilità di far 
girare tutta una serie di linguaggi 
ricompilando il sorgente in una sorte 
di Byte Code sta ottenendo in tempi 
brevi un successo enorme. D'altra 
parte Java che è nato più di 10 anni fa 
non ha colto immediatamente questa 
opportunità. Vedremo se nel tempo i 
progettisti di Sun sapranno recuperare 
il terreno perduto. 

ORACLE RILASCIA 
URIA MUOVA 
VERSIONE DI 
BERKELEY DB 

'ono passati pochi mesi da quando 
Oracle ha acquistato Berkeley DB 
ed ecco arrivare immediatamente una 
nuova versione. Le innovazioni ri- 
guarderebbero una serie di interfacce 
API messe a disposizione dei pro- 
grammatori Java e un nuovo motore 
di persistenza. Se si considera che Berke- 
ley DB è uno dei primi software di da- 
tabase ad essersi affacciato sul merca- 
to e se si considera la sua natura open- 
source, appare chiara la volontà di Ora- 
cle di affacciarsi su un mercato, ovve- 
ro quello delle piccole e medie aziende, 
che fino ad ora gli era sfuggito total- 
mente. Sia il rilascio di una versione 
Express di Oracle 10g sia il rilascio di 
questa nuova versione di Berkeley DB 
lasciano intuire quanto sia appetibile il 
mercato delle piccole e medie impre- 
se, soprattutto per i produttori di softwa- 
re database oriented 



Sesta edizione per il Microsoft 
Technet Security Workshop. Si è 
tenuto a Milano il 13 e il 15 Giugno il 
consueto appuntamento con i profes- 
sionisti delNnformation Technology 
sui temi della sicurezza. Quest'anno 
l'intero workshop ha focalizzato la 
propria attenzione sulle tecnologie e I 
protocolli su cui si basano I certificati 
di autenticazione e sulle modalità con 
cui possono essere utilizzati. "Ci rivol- 
giamo ai professionisti IT per affronta- 
re uno dei temi che da anni ci é più a 
cuore: la sicurezza delle infrastrutture 
e dei sistemi. Così è nato sei anni fa il 
TechNet Security Workshop", aveva 
dichiarato Raffaella Verticchio, 
TechNet Program Manager di 
Microsoft Italia. "L'obiettivo è fornire 
a tutti coloro che si occupano della 
gestione dei sistemi IT nelle aziende 



italiane momenti di aggiornamento e 
confronto sulle nuove tecnologie e sui 
nuovi prodotti in grado di incremen- 
tare il livello di sicurezza in azienda. In 
particolare, quest'anno parleremo di 
certificati digitali, l'elemento chiave 
delle moderne tecnologie informati- 
che in tale ambito". Particolare atten- 
zione dunque ai certificati digitali e 
alle tecnologie ad essi correlati, segno 
che il traffico di rete sta diventando 
sempre più la catena debole su cui 
concentrare l'attenzione se si voglio- 
no evitare problemi seri di sicurezza. 
In una società in cui la nostra intera 
identità può sempre in una qualche 
misura risiedere in rete è importante 
capire come si possa concentrare la 
propria attenzione sulle parti che 
compongono una transazione, consu- 
mer e server. In tutto questo non 



JPEG AVRÀ UM EREDE 



Si chiama WMPhoto, ovvero Windows 
Media PHOTO ed ha fatto capolino sul 
mercato durante la recente Windows 
Hardware Engineering Conference. A 
presentarlo è stata Microsoft che ha 
annunciato di voler includere il nuo- 
vo formato nel na- 
scituro Windows Vi- 
sta. Secondo la casa 
di Redmond, il nuo- 
vo formato ha tut- 
te le carte in regola 
per soppiantare 
l'onnipresente JPEG. 
L'algoritmo di com- 
pressione al suo in- 
terno è tale da ga- 
rantire, sempre se- 
condo Microsoft, di- 
mensioni dimezza- 
te rispetto alla nor- 
male compressio- 
ne JPEG. Il Windows Media Photo si 
pone neir agguerrito gruppo dei for- 
mati di compressione elaborato da Mi- 
crosoft ovvero Windows Media Video e 
Windows Media Audio. Se le aspettative 
fossero rispettate, il nuovo formato di- 
verrebbe in breve tempo uno standard 




per quanto riguarda i dispositivi mobili. 
Certamente WMPhoto potrebbe risul- 
tare utile anche sui dispositivi standa- 
lone, ma data la crescente disponibilità 
di periferiche di Storage capaci di con- 
tenere enormi moli di dati a prezzi con- 
tenuti, probabil- 
mente non ci sa- 
rebbe in questo 
senso una grande 
rivoluzione. Allo 
stesso modo l'au- 
mento della lar- 
ghezza di banda fa 
si che la dimen- 
sione delle foto non 
sia più un proble- 
ma anche sul Web. 
Viceversa nei di- 
spositivi mobili 
questo tipo di for- 
mato troverebbe 
una collocazione ideale. E se si pensa 
che il nuovo Windows Mobile 5.0 sta 
ormai scalando molte posizioni nella 
classifica dei sistemi operativi per si- 
stemi mobili, c'è da scommettere che 
WMPhoto otterrà sicuramente un buon 
successo. 
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poteva non mancare uno sguardo attento 
alle tecnologie WiFi e alle problematiche di 
sicurezza che queste ultime hanno messo 
in luce. In una società in continua evoluzio- 
ne, in cui palmari, smartphone e altri dispo- 
sitivi rendono mobile persino il concetto di 
rete aziendale, diventa importante proteg- 
gere le proprie credenziali di autenticazio- 
ne e i propri dati. Moltissimi sforzi devono 
essere fatti per "educare" utenti e sistemi- 
sti ad una nuova logica di gestione che sta 
irrompendo velocemente all'interno di abi- 
tudini consolidate, non lasciando il tempo 
ai gestori di adeguarsi, ma molto deve 
essere fatto anche in termini di progetta- 
zione di applicazioni sicure che tengono 
conto delle sempre possibili incertezze del- 
l'utente inesperto e della contrapposta fur- 
bizia di chi invece studia la rete in tutti i 
suoi meccanismi più per ottenere un van- 
taggio da eventuali buchi lasciati scoperti 



TRE BETA PER 
MICROSOFT 



Windows Vista, Office 2005 e Longhorn 
Server. Sono queste le tre nuove ver- 
sioni Beta annunciate a "reti unificate" da 
Microsoft durante la recente Windows 
Hardware Engineering Conference. Il ri- 
lascio di queste tre nuove versioni in mo- 
do pressoché contemporaneo è sinonimo 
secondo Microsoft di sinergia e collabo- 
razione. Di fatto questi tre software costi- 
tuiscono una piattaforma operativa al- 
l'interno della quale si muovono in per- 
fetta sincronia tutti gli attori di un'ottima 
infrastruttura informatica. I tre pilastri di 
questa architettura sono costruiti per in- 
teragire in modo stretto fra di loro favo- 
rendo una maggiore usabilità da parte de- 
gli utenti. Gli obiettivi sui quali Microsoft 
si sarebbe concentrata sono quattro: ga- 



rantire una piattaforma di collaborazione 
semplice fra le persone, migliorare la pro- 
tezione dei contenuti, offrire degli stru- 
menti di ricerca evoluti, migliorare la si- 
curezza generale. C'è soddisfazione in ca- 
sa Microsoft per questo annuncio, ma si 
è anche immediatamente aperto il fron- 
te delle polemiche. Longhorn integrereb- 
be infatti una piattaforma di virtualizza- 
zione piuttosto evoluta, e nelle parole di 
J. Woolsey , lead program manager della 
divisione Windows di Microsoft , migliore 
di qualunque altro conconente. Non si è fat- 
ta attendere la risposta diVMware che per 
bocca di uno dei suo vicepresidenti: Ra- 
ghu Raghuram Raghuram, ha dichiarato 
VMWare sarà subito in grado di sfruttare tut- 
te le migliorie offerte da Longhorn 



PROGRAMMA 

E VINCI 

UNA XBOX 360 

E' il premio messo in palio da Microsoft 
alla prima shared source program- 
ming contest. I partecipanti possono sca- 
ricare una trial version di Windows CE 
che rimarrà valida per 120 giorni e tutta 
una serie di strumenti di sviluppo ad es- 
sa correlati. In cambio dovranno pro- 
durre software di una qualche utilità nel 
mondo reale. I giudici premieranno l'o- 
riginalità, la documentazione, la reale 
utilità, e porranno una particolare at- 
tenzione ad un piccolo video dimostrativo 
che dovrà essere realizzato dai parteci- 
panti. In palio c'è un pacchetto conte- 
nente una XBOX 360, un televisore da 34 
pollici e una marea di software per un to- 
tale di circa 2500$, sono ovviamente pre- 
visti anche premi minori. Le iscrizioni 
scadranno il 28 luglio e il vincitore sarà 
annunciato intorno alla metà di Agosto. 
L'entusiasm è già alto e le iscrizioni pro- 
cedono a ritmo incessante. 
Chi volesse partecipare può trovare tut- 
te le informazioni all'indirizzo 
http://www.windowsfordevices.com/ar- 
ticles/AT5277795 134.html 



IN ARRIVO SOA 2.0 



A pplicazioni basate su servizi e 
che comunicano fra loro trami- 
te messaggi, in una parola Service 
Oriented Application, ovvero SOA. 
E' questa la parola chiave del 
momento, la meta verso cui tutte le 
aziende produttrici di software si 
dirigono. Così Oracle ha deciso di 
bruciare i tempi e 
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grammazione 
basata su servizi e quella basata su 
eventi. 

"SOA 2.0 è il temine che usiamo per 
parlare della combinazione della 
combinazione di architetture servi- 
ce-oriented e architetture event- 
dirven" questo è quanto ha dichia- 
rato "Steve Harris" vice presidente 
di Oracle Fusion Middleware. Allo 



stesso modo Yefim Natis ha specifi- 
cato: "SOA così come lo conoscia- 
mo oggi propone un'architettura 
client server fra moduli software 
con i servizi che diventano una 
sorta di subroutine dei client", l'ar- 
chitettura proposta da SOA 2.0 
invece prevede che i servizi possa- 
no lanciare alert 
o eventi di notifi- 
ca verso il client, 
diventano in que- 
sto modo ele- 
menti attivi del- 
l'architettura. 
Come partner per 
lo sviluppo di 
SOA 2.0, Oracle 
ha individuato la piattaforma Java 
Enterprise 5, inoltre è molto proba- 
bile che in tutta l'architettura una 
parte dominante l'avrà Ajax ovvero 
la tecnologia di tunneling http su 
cui si sta basando buona parte del 
WEB moderno. Il tool di sviluppo 
principe su cui sarà incentrata l'in- 
tera piattaforma sarà JDeveloper, 
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SVILUPPO PER 
DISPOSITIVI MOBILI 

PROGETTIAMO UNA COMPLETA APPLICAZIONE ED ENTRIAMO NELLA LOGICA DI 
FUNZIONAMENTO DELLA NUOVA VERSIONE DEL COMPACT FRAMEWORK E DI WINDOWS 
MOBILE 5.0. USIAMO VISUAL STUDIO 2005 PER RENDERE TUTTO PIÙ SEMPLICE 





Windows XP/2003, .net 
Framework 2.0, 
Microsoft Visual Studio 
.NET 2005, Windows 
Mobile 5.0 SDK, SQL 
Server 2005 Mobile 
Edition 




LJ informatica ha letteralmente cambia- 
to il nostro modo di lavorare. Le 
I comunicazioni sono più rapide, le 
distanze si sono ridotte, il lavoro ripetitivo è 
stato pressoché eliminato, la produttività è 
aumentata. Molte sono le tecnologie che, 
insieme, hanno contribuito a questo radicale 
cambiamento del nostro modo di lavorare. Si 
va dalla potenza di calcolo dei computer 
notevolmente aumentata negli ultimi anni, 
alla connettività sempre più presente ed eco- 
nomica. 

Uno degli elementi chiave che però ha contri- 
buito maggiormente a modificare il nostro 
modo di lavorare è il concetto di Mobility. 
"Business Everyware" è uno dei tanti slogan 
che si legge durante la presentazione di tutto 
ciò rientra nel concetto di mobility. Slogan 
che, a mio parere, rende perfettamente l'idea 
di quello che sta accadendo. 
Se di recente avete preso un aereo, sapete a 
cosa mi riferisco. 

Le sale d'attesa sono cambiate e, le persone 
sedute a leggere il giornale sono state pian 
piano sostituite da persone con un PC porta- 
tile appoggiato sulle ginocchia che magari 
stanno rispondendo ad una mail o stanno 
inviando un ordine in azienda. 
Personalmente, grazie ad uno smartphone ed 
una connessione GPRS, non raramente mi 
capita di rispondere a qualche mail mentre 
sono bloccato nel traffico. 
Il nostro modo di lavorare sta cambiando, che ci 
piaccia o no. Quello che possiamo fare, come svi- 
luppatori, è cogliere le opportunità che questi 
cambiamenti ci riservano, producendo software 
adeguati. In questo articolo, dopo una panora- 
mica sui dispositivi mobili in generale, passere- 
mo alle novità introdotte dal nuovo sistema ope- 
rativo Microsoft denominato Windows Mobile 
5.0 e la nuova versione del Compact Framework 
(2.0). Grazie ad essi, realizzeremo poi una appli- 
cazione per la gestione delle spedizioni. 
Mettiamoci subito all'opera. 



I DISPOSITIVI MOBILI 

La scelta di dispositivi mobili oggi è, fortuna- 
tamente, abbastanza vasta. Per ogni partico- 
lare esigenza, ci sono a disposizione numero- 
si dispositivi, diversi per caratteristiche 
hardware, funzionalità e, cosa non meno 
importante, il costo. 

Principalmente, le tipologie di dispostivi 
mobili, sono 4: 

• Dispositivi industriali. 

• Pocket PC. 

• Pocket PC con funzionalità telefoniche. 

• Smartphone. 

Nella prima categoria rientrano tutti i disposi- 
tivi caratterizzati principalmente da una ele- 
vata robustezza. Il loro ambito di utilizzo è 
generalmente quello industriale, su cantieri o 
magazzini e, di conseguenza, devono essere 
resistenti agli urti, alla polvere ed all'umidità. 
Generalmente questo tipo di dispositivi è 
abbastanza costoso, ma sono indispensabili 
nei contesti sopra elencati. Il secondo tipo di 
dispositivi invece è caratterizzato da un 
amplio display, dal supporto all'input con la 
penna, dal display touch screen e, sempre più 
spesso, da una piccola tastiera querty integra- 
tala terza categoria è identica alla preceden- 
te a cui però si aggiungono le funzionalità 
telefoniche. Gli Smartphone invece, sono 
molto simili a dei normali telefoni cellulari. 
Caratterizzati da un display più piccolo dei 
Pocket PC, non sono dotati ne di touch screen 
ne di tastiera, se non quella numerica classi- 
ca. Sono molto comodi per controllare la 
posta, rispondere a brevi messaggi, avere con 
se una rubrica ed una agenda sincronizzabili 
con Microsoft Outlook ed, ovviamente, per 
telefonare. La loro natura però li rende decisa- 
mente scomodi per navigare o qualora si 
abbia la necessità di scrivere parecchio. 
Quando si sceglie un dispositivo, bisogna 
considerare innanzitutto l'uso che se ne deve 
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fare. Se il nostro obiettivo principale è quello 
di poter sempre ricevere la posta elettronica e 
gestire i nostri appuntamenti, la scelta più 
opportuna sarò uno Smartphone (piccolo e 
comodo da trasportare). Se al contrario siamo 
dei rappresentanti, un Pocket PC (magari 
Phone Edition) sarebbe la scelta più sensata. 

Windows Mobile 5.0 

Windows Mobile 5.0 è l'ultimo sistema opera- 
tivo Microsoft per dispositivi mobili. Ne esito- 
no 3 versioni principali, ognuna adatta ad un 
particolare dispositivo mobile: 

• Pocket PC Edition: è la versione per dispo- 
sitivi Pocket PC privi di funzionalità telefo- 
niche. 

• Pocket PC Phone Edition: è la versione per 
dispositivi dotati di funzionalità telefoni- 
che 

• Smartphone Edition: è la versione per 
dispositivi Smartphone 

Ognuna delle versioni di Windows Mobile 5.0 
elencate, ha funzionalità specifiche per il tipo 
di device per cui è stata progettata. Nella ver- 
sione Smartphone ad esempio, mancheranno 
il supporto per la tastiera e per l'input tramite 
penna. Quando dobbiamo sviluppare una 
applicazione per dispositivi mobile, dobbia- 
mo tenere conto del device in su cui essa 
dovrà essere istallata. Questo per non incorre- 
re in problemi dovuti all'assenza di supporto 
per determinate funzionalità. 
Se ad esempio dobbiamo sviluppare un 
software per la gestione delle spedizioni 
(come quello presentato in queste pagine), 
dobbiamo considerare il fatto che avremo la 
necessità di inserire e visualizzare corretta- 
mente dei dati. La scelta di uno smartphone 
come target, potrebbe non essere la più sen- 
sata. Windows Mobile 5.0 introduce numero- 
se novità, non tutte elencabili in queste pagi- 
ne. Ci concentreremo quindi principalmente 
su quelle che riguardano lo sviluppo di appli- 
cazioni.il punto centrale del rinnovamento di 
Windows Mobile 5.0 per gli sviluppatori è 
l'aumento della produttività. Innanzitutto è 
stato aumentata la compatibilità tra le appli- 
cazioni Pocket PC e Smartphone rendendo di 
fatto meno dolorosa la loro migrazione (resta 
inteso che sarebbe comunque opportuno sce- 
gliere adeguatamente la piattaforma). 
L'aumento della produttività è anche dovuto 
ad una serie di nuove API che espongono al 
mondo managed, molte delle funzionalità del 
sistema operativo. Tra le più significative ci 
sono indubbiamente: 



• Funzionalità di telefonia: che permettono 
di interagire con le funzionalità telefoniche 
dei sistemi Phone Edition e Smartphone 

• Outlook Mobile: che semplificano notevol- 
mente Fuso delle funzionalità di Outlook 
Mobile attraverso applicazioni managed 

• Confìguration Manager: fornisce la possi- 
bilità di impostare numerosi parametri di 
configurazione del device attraverso un file 
xml. 

• Uso della fotocamera: le funzionalità di 
cattura immagini e video della fotocamera 
sono ora esposte. E' quindi possibile, con 
estrema semplicità, dotare le nostre appli- 
cazioni di funzionalità legate all'uso di 
questo dispositivo. 

• GPS: rappresentano un set di funzionalità 
intermedio che permettono di accedere 
con semplicità ai dati GPS. Particolarmente 
utili quando si ha la necessità di applica- 
zioni che usano ad esempio MapPoint. 

• Integrazione di active Sync: è ora possibile 
avviare o sospendere via codice la sincro- 
nizzazione dei dati via Active Sync 

L'insieme di queste funzionalità native e del 
nuovo Microsoft .NET Compact Framework, 
rendono possibile lo sviluppo di applicazioni 
complesse e ricche di funzionalità molto più 
semplicemente che in passato. 



LE NOVITÀ DEL 
COMPACT 
FRAMEWORK 2.0 

Recentemente, Microsoft ha rilasciato la 
nuova versione del .NET Framework (la 2.0) 
che include anche la versione per dispositivi 
mobili denominata Compact Framework. 
Questa versione, dato il tipo di dispositivi su 
cui deve essere installata ed eseguita, è chia- 
ramente una versione ridotta del framework 
installabile sui tradizionali PC. Non includa 
tutti i namespace e tutte le funzionalità del 
fratello maggiore, il Compact Framework per- 
mette di sviluppare applicazioni anche deci- 
samente complesse per Pocket PC e 
Smartphone. In particolare, questa nuova ver- 
sione, introduce numerose funzionalità sia 
per quanto riguarda la migliorata compatibi- 
lità con il tradizionale framework, sia per 
novità nello sviluppo di interfacce utente che 
di integrazione con il sistema operativo. 
In questo paragrafo, analizzeremo alcune tra 
le novità introdotte dalla versione 2.0. Per 
ovvie esigenze di spazio, verranno tralasciate 
quelle meno importanti, comunque consulta- 
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bili on line all'indirizzo riportato nel box late- 
rale. 
Iniziamo dall'interfaccia grafica: 

• Notification: sfrutta il sistema di notifiche 
di Windows Mobile per segnalare eventi 
con dei baloon (stile Windows XP). Oltre 
alla semplice visualizzazione, questo 
nuovo controllo permette di gestire un 
eventuale input di un utente. 

• DocumentList: permette di navigare nel 
file system del dispositivo per scgliere, 



Tutte le novità relative copiare, eliminare dei files. 
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Fig. 1: La comparazione tra le toolbar delie due ver- 
sioni di Visual Studio 



mework, questo controllo era disponibile 
solo per Pocket PC. Da oggi è disponibile 
anche per Smartphone. 



• Splitter e Toolbar: sono state aggiunte 
anche sul Compact Framework. 

• User Control: come per il .NET Framework, 
ora sarà possibile sviluppare user control 
anche per dispositivi mobili. Tali user con- 
trol potranno essere inseriti nella toolbox 
ed usati in altri progetti. 

• Display and Layout: in questa categoria 
rientrano una serie di nuove caratteristiche 
utili a migliorare la gestione dell'interfaccia 
come control docking, control anchoring, 
automatic scrolling etc. 

Per rendersi immediatamente conto della 
quantità di controlli aggiunti in questa nuova 
versione, possiamo paragonare le toolbox di 
Microsoft Visual Studio .NET 2003 e Microsoft 
Visual Studio .NET 2005. In Figura 1, sono 
riportate entrambe affiancate. 
La maggior parte delle applicazioni oggi, fa 
uso di un Data Base in cui archiviare i dati. Le 
applicazioni per dispositivi mobili non fanno 
eccezione. Ecco quindi alcune novità intro- 
dotte dal nuovo framework a tal proposito: 

• SqlCeResultSet: fornisce un accesso al 
Data base Sql Server 2005 Mobile Edition 
molto più veloce e leggero di un Data Set. 
SqlCeResultSet può essere usato come 
Binding Source per i nostri controlli. 

• DataSet: è stato introdotto anche nel 
Compact Framework questo comodo com- 
ponente per la gestione disconnessa dei 
dati. 

Tra le altre funzionalità aggiunte, è importan- 
te sottolineare le seguenti: 

• Supporto migliorato per XML 

• Web Service più performati grazie alle 
migliorie fatte alFXMLSerializer 

• Serial Port: introdotto nativamente in que- 
sta versione del Compact Framework, sem- 
plifica notevolmente lo sviluppo di appli- 
cazioni che hanno necessità di interfac- 
ciarsi con dispositivi seriali come lettori di 
codici a barre o RFID. 

• Supporto migliorato per la crittografia 
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• Threading: introduce la possibilità di svi- 
luppare applicazioni multithreading anche 
su dispositivi mobili. Tale funzionalità è 
decisamente importante al fine di svilup- 
pare applicazioni che non blocchino l'in- 
terfaccia utente in attesa del completa- 
mento delle operazioni. 

• Performance: in aggiunta a quanto fin ora 
commentato, nel .NET Compact 
Framework sono stati introdotti significati- 
vi incrementi di performance che abbrac- 
ciano sostanzialmente tutti i campi di 
applicazione. 

Dopo aver visto le novità di Windows Mobile 
5.0 e del .NET Compact framework 2.0, inizia- 
mo con lo sviluppo della nostra prima appli- 
cazione, ma non senza prima aver fatto qual- 
che doverosa considerazione sullo sviluppo 
su dispositivi mobili. 



CONSIDERAZIONI 
SULLO SVILUPPO 

Prima di iniziare con lo sviluppo di applicazioni 
per questo tipo di dispositivi, è bene fare alcune 
considerazioni importanti per evitare errori di 
progettazione che potrebbero portarci, un 
domani, a dover rivedere l'intera applicazione. 
La prima cosa da considerare quando ci si 
approccia allo sviluppo di una applicazione per 
dispositivi mobili è la dimensione dei display. 
Mediamente, lo spazio a diposizione è di 
250x250 pixel (dall'area totale a disposizione 
devono essere esclusi lo spazio per la barra supe- 
riore e quello dei menù in basso. 
In questo spazio decisamente limitato, dovran- 
no trovarsi tutte le informazioni più utili per 
svolgere il task specifico per cui quel form è stato 
realizzato. 

Altra cosa da tenere sempre a mente è che, chi 
utilizzerà la nostra applicazione, non siederà 
comodamente di fronte ad un PC con ampio 
display, tastiera e mouse ma, nella maggior parte 
dei casi avrà il device in una mano e dovrà inte- 
ragire con la nostra applicazione con il pennino. 
E' quindi sconsigliabile avvicinare troppo tra 
loro i controlli che necessitano di una interazio- 
ne con l'utente, come bottoni, caselle di input 
etc. Molto importante risulta il posizionamento 
dei controlli, specie per quelli che richiedono 
una compilazione attraverso il pennino o la 
tastiera su schermo. 

Il panel di input infatti, normalmente nascosto, 
potrebbe coprire i controlli che stiamo compi- 
lando, rendendo molto scomoda la compilazio- 




Fig. 2: II posizionamento dei controlli su applicazioni 
per PPC. 

ne. Vediamo subito un esempio di quello che 
NON si dovrebbe fare, in figura 2. Le scelte di 
design in questo tipo di progetto sono fonda- 
mentali. 

Tra le altre cose da considerare, non è da sottova- 
lutare la potenza di calcolo ridotta di questi 
dispositivi. Oltre alle ottimizzazioni necessarie 
da fare sul codice, va mostrato all'utente che 
l'applicazione non è bloccata, ma sta lavorando 
al completamento di un determinato task. 
La cosa è fattibile usando controlli come la pro- 
gress bar o modificando il cursore impostandolo 
aWaitCursor. 



RONIZZAZIONE DEI DATI 






SUL WEB 



Il sito web Microsoft 
per sviluppatori, dedi- 
cato al mondo dei 
dispositivi mobili, è 
consultabile al seguen- 
te indirizzo: 
http://msdn.microsoft.co 
m/mobility/ Partendo 
dalla pagina iniziale, si 
po' avere accesso a 
tutte le informazioni 
utili allo sviluppo per 
dispositivi mobili. 



la sincronizzazione dei dati tra un 
dispositivo mobile ed un server 
centrale può avvenire in 3 modi 
distinti: usando le repliche di SQL 
Server, usando RDA (Remote Data 
Access) ed usando un servizio web. 
Le repliche sono molto potenti e 
consentono una dettagliata 
gestione dei conflitti, cosa 
frequente quando si lavora con 
utenti disconnessi. Hanno però lo 
svantaggio di essere complesse da 
configurare e, in alcuni casi, da 
gestire. 



Remote Data Access è più semplice 
da configurare ma ha un sistema 
poco evoluto per la gestione dei 
conflitti. L'ultimo, il Web Service, 
lascia agli sviluppatori il compito 
di gestire l'intero processo di 
sincronizzazione nonché di 
gestione dei conflitti, ma ha il 
vantaggio di non dipendere dal 
Data Base. Al seguente indirizzo 
web http://msdn2.microsoft.com/en- 
us/library/ms172916.aspx, è 
disponibile una comparazione tra 
RDA e Repliche. 
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Il Microsoft Windows 

Mobile 5.0 SDK è 

scaricabile al seguente 

indirizzo web: 

http://www.microsoft.co 

m/down loads/details.aspx 

?familyid=83A52AF2- 

F524-4EC5-9155- 

717CBE5D25ED&displavla 

ng=en ed include gli 

emulatori ed i 

template di Microsoft 

Visual Studio .NET 

2005. 



L'APPLICAZIONE 

Dopo aver analizzato le varie novità introdot- 
te da Windows Mobile 5.0 e dal Micorsoft 
.NET Compact Framework 2.0, realizziamo 
una applicazione d'esempio che metta insie- 
me un po' delle novità appena viste. 
Come tipo di applicazione si è scelto di realiz- 
zare un classico programma per la creazione 
di ordini, usato generalmente dai rappresen- 
tanti. Il programma fa uso di un Data Base 
SQL Server 2005 Mobile Edition locale per la 
memorizzazione dei dati che poi potrà essere 
eventualmente sincronizzato con un Data 
Base centrale. 

L'argomento della sincronizzazione, data la 
sua vastità e complessità (specie in merito alla 
gestione dei conflitti), non verrà trattato in 
questo articolo. Verranno comunque forniti 
dei riferimenti alla documentazione on line. 
Per lo sviluppo di questa applicazione di 
esempio, sono stati usate alcune delle novità 
di maggior rilievo introdotte dal Compact 
Framework e da Windows Mobile 5.0. 
Useremo i nuovi BindingSource, SQL Server 
2005 Mobile edition, Notifications e due fun- 
zionalità per comunicare con il sistema ope- 
rativo: inserire un appuntamento in Pocket 
Outlook e chiamare telefonicamente il cliente 
recuperando il numero di telefono dal Data 
Base. Mettiamoci all'opera. 



IMPOSTIAMO 
IL PROGETTO 

Dovendo sviluppare un sofware per Windows 
Mobile 5.0, è necessario scaricare il relativo 
Software Development Kit dal sito web di 
Microsoft (vedi box laterale). Una volta instal- 
lato, sarà sufficiente creare una nuova appli- 
cazione per Smart Device in Microsoft Visual 
Studio .NET 2005 scegliendo come target 
naturalmente Windows Mobile 5.0 




Una volta creato il progetto, dobbiamo sce- 
gliere su quale tipo di device deve essere 
testato. Selezioniamo dall'elenco Windows 
Mobile 5.0 Pocket 
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Windows Mobile 5.0 Pocket PC Square Emulator 
Windows Mobile 5.0 Pocket PC Square VGA EmuJator 
Windows Mobile 5.0 Pocket PC VGA Emulator 
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Fig. 4: Scelta del Device 

Infine aggiungiamo i riferimenti alle API di 
Windows Mobile 5.0, in particolare a 
PocketOutlook e Telephony 
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Fig. 5: Aggiunta dei riferimenti 

Una volta predisposto il progetto, dobbiamo 
aggiungere il Data Base che sarà utilizzato per 
la memorizzazione dei dati. Chi ha lavorato 
con Microsoft Visual Studio .NET 2003 su 
applicazioni per dispositivi mobili, ricorderà 
quanto questa operazione fosse poco pratica. 
Il Data Base andava creato direttamente sul 
dispositivo o usando lo scomodo Query 
Analyzer installato, o creandolo via codice. In 
ogni caso, dall'interno dell'ide, non era possi- 



Fig. 3: Creazione del progetto in Microsoft Visual 
Studio .NET 2005 







Ita*» 






mm 


Visual Studio installed tempia tes 




; c 'jt Interface 
j|] User Control 

:-t -f- _'-■; :■■■ : 

j^ XML File 
V] HTML Page 
^jEitmap File 
^Resources File 




|!I] Windows Form 
£] Code File 

^Design-Time Attribute Rie 
yjCustom Control 
[Jj XML Schema 
^StyeSheet 
t^ Curaor File 
U Class Diagram 

HyTempfates 


^ Class 

$] Component Class 

^Inherited Form 

l^jDatsSet 

_^XSLTFile 

jjj] Iran File 

; J SQL Mobile Database 


jj| Search Online Templates, , , 




An empty SQL Mobile database file 
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Fig. 6: Aggiunta del Data Base al progetto. 
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bile lavorare sul Data Base. 
Questa limitazione è finalmente stata elimi- 
nata con questa versione. Sarà quindi suffi- 
ciente aggiungere al progetto un nuovo ele- 
mento e selezionare la voce SQL Mobile 
DataBase 











2 \%n 


E- [jl Data Connections 






É Cfe AppDatabaae.sdf 








È- Ej Tables 










E- [ 3 tblClientì 












B- □ Columns 














f IDCliente 














=\ Nominativo 














f] Indirizzo 














E Citta 














■ [E CAP 














[ Provincia 














f] Tenefbno 












- 


■I-- Ci Indexes 










H 


H 


j jG3SSSSS!SSSS3B§l 










H 


H 


iZ\ tblOrdini 










H 


H 


^ tblProdottì 








E ■■■ E3 System Vlews 








È ■ EjI Replication 








É- [^ ri 4M» *_*» **. 








Q... H ri 4*»* *_<- fc. 








È- [jj •* **■* *'>r * fe- 








È- EL «* »«■* ***** +- 






B- .ri| Serverà 






È Jg e0785904 




"J^-Toolbox .-^Server Explorer 





F/i* 7: Gestione del Data Base dal panel Server 
Explorer. 

Il Data Base sarà poi facilmente gestibile 
attraverso il panel Server Explorer di 
Microsoft Visual Studio .NET 2005. 
L'aggiunta di un Data Base, comporterà la 
creazione automatica di un Data Set che sarà 
la nostra sorgente di dati in tutta l'applicazio- 
ne. Sebbene avessimo potuto interagire diret- 
tamente con il Data Base, l'utilizzo del Data 
Set rende estremamente rapido l'associazione 
dei dati ai controlli delle nostre interfacce. 



BINDINGSOURCE 

Il componente BindingSource rientra nelle 
novità del Compact Framework 2.0 e più in 
generale, del Microsoft .NET Framework stes- 
so. Lo scopo di questo componente è quello di 



semplificare l'associazione dei controlli alla 
base dati. E' possibile usare questo compo- 
nente per creare associazioni semplici come 
ad esempio una textBox ad un campo specifi- 
co del Data Base o associazioni più complesse 
come ad esempio una tabella di un Data Base 
ad una Data Grid. 

Nel nostro caso specifico, l'oggetto Binding 
Source si rivelerà molto comodo per entram- 
be le esigenze, soprattutto per creare form in 
cui i controlli si aggiornano sulla base di un 
record selezionato nella Data Grid. 
Aggiungere un BindingSource al form è una 
operazione estremamente rapida. Ci basterà 
trascinarlo sulla form e configurarne l'asso- 
ciazione ai dati. 

Vediamone un esempio pratico nella foto in 
basso. 
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Fig. 8: Il BindingDataSource 

Il componente BindingSource viene trascina- 
to nel relativo form e consentirà di associare i 
dati scelti ai controlli dell'interfaccia utente. 
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Fig. 9: Associamo la fonte dati 

Il secondo passo da fare, sarà quello di indica- 
re al BindingSource, quale sarà la fonte da cui 
attingere i dati. Nel nostro caso, scegliamo il 
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Fig. 10: Associamo le tabelle 
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Data Set che abbiamo creato al momento 
della creazione del Data Base 
L'ultimo step sarà quello di definire quale 
delle tabelle incluse nel DataSet, sarà asso- 
ciata al controllo. Nel nostro caso, selezionia- 
mo la tabell tblClienti. 

Da questo istante, possiamo far riferimento 
al nuovo BindingSource per creare associare i 
dati ai controlli. Nel prossimo paragrafo, ana- 
lizzando la creazione del primo form, vedre- 
mo più in dettaglio come fare. 



IL PRIMO FORM 

Dopo aver visto come creare un Data Base 
per dispositivi mobili, come creare una fonte 
dati per i controlli Windows Forms e aver 
analizzato alcune linee guida per il posizio- 
namento dei controlli, diamo realizziamo il 
primo form della nostra applicazione. 
Iniziamo quindi dalla scelta del cliente a cui 
associare l'ordine. Se stessimo sviluppando 



Pocket PC Phone-WM 5,0 



File Flash Help 




Fig. 11: II form con i dati dei clienti. 

una applicazione Windows, probabilmente 
basterebbe creare una DataGridView che 
mostri i clienti e dare la possibilità all'opera- 
tore di selezionarne uno direttamente dalla 
griglia. Sfortunatamente, con 250 pixel di lar- 
ghezza, questa operazione potrebbe rivelarsi 
decisamente difficile. Ci conviene quindi 
strutturare il form con una griglia sintetica 
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Fig. 12: L'associazione dei controlli alla fonte dati. 



un cui compare il nome del cliente e la città, 
e fornire i dettagli all'esterno della griglia, in 
delle normali label che andremo poi ad asso- 
ciare ai dati. Il form dovrebbe apparire come 
in figura. 

Selezionando un cliente diverso dalla griglia 
in alto, i controlli in basso si aggiorneranno 
con i dati del cliente stesso. Questo compor- 
tamento è possibile in quanto sia la DataGrid 
che i controlli, hanno la stessa fonte dati che 
nel nostro caso è il BindingSource creato nel 
paragrafo precedente. 

L'associazione dei controlli viene fatta, per 
ogni controllo, selezionando la voce 
(DataBinding) della finestra relativa alle pro- 
prietà. La stessa, comoda, tecnica è stata 
usata per tutti gli altri controlli. Questa com- 
binazione di oggetti (Data Base, DataSet 
tipizzato e BindingSource) permette la crea- 
zione di applicazioni data oriented in tempi 
decisamente ridotti rispetto a quanto avveni- 
va in passato. 



LE FUNZIONALITÀ 
TELEFONICHE 

Tra le novità di Windows Mobile 5.0, è stata 
sottolineato l'aumento di API che permetto- 
no di interagire con funzionalità dei Sistema 
Operativo direttamente dal mondo managed. 
Una di queste è la possibilità, per le versioni 
Phone Edition, di interagire con la parte 
telefonica in modo estremamente semplice. 
Nel form mostrato nel paragrafo precedente, 



► 18 /Luglio 2006 



http://www.ioprogrammo.it 



Programmare con il compact framework ■ ▼ COVER STORY 



tra le informazioni relative al cliente c'è ovvia- 
mente il numero di telefono. Se volessimo 
chiamarlo per segnalargli il nostro ritardo, 
dovremmo appuntarci il numero da qualche 
parte, avviare l'interfaccia telefonica e com- 
porre il numero. Grazie al namespace 
Microsoft.WindowsMobile. Telephony invece, 
questa operazione sarà possibile farla diretta- 
mente dall'interno dell'applicazione e con 
pochissimo codice: 

private void btnChiama_Click(object sender, 

EventArgs e) { 
Phone myPhone = new Phone(); 
myPhone.Talk(lblTelefono.Text, true); 



Grazie a questo semplice codice, verrà avviata 
direttamente l'interfaccia telefonica e compo- 
sto il numero, senza dover uscire dall'applica- 
zione. 



INTEGRAZIONE CON 
POCKET OUTLOOK 

Altra funzionalità molto comoda è quella rela- 
tiva all'integrazione con Pocket Outlook. 
Nella nostra applicazione ad esempio, 
potremmo far generare un appuntamento nel 



'àM, 



File Flash Help 




calendario coincidente con la consegna del- 
l'ordine in modo che, al momento della con- 
segna, il nostro utente può essere avvisato. In 
caso di gestione di più ordini, il rappresentan- 
te potrebbe anche organizzare al meglio gli 
appuntamenti intervenendo direttamente sul 
calendario.L'aggiunta di un appuntamento, 
grazie ancora alle nuove API esposte, è decisa- 
mente semplice: 

Appointment appointment = new Appointment(); 
appointment.Subject = "Consegna ordine " + 

_CodiceOrdine; 



appointment. Start = new DateTime( 
dateTimePickerl.Value.Year, 



dateTimePickerl.Value.Month, 



dateTimePickerl.Value.Day, 



10, 



00, 



00 



); 



appointment. Duration = new TimeSpan(00, 30, 



00); 



appointment. ReminderVibrate = true; 
appointment. ReminderRepeat = true; 

using (OutlookSession session = new 

OutlookSession()){ 
session. Appointments.Items.Add(appointment); 
} 



Fig. 13: II nostro appuntamento inserito in 
PocketOutiook. 



Il risultato sarà quello di figura 6. 



CONCLUSIONI 

La nuova versione del Microsoft .NET 
Compact Framework, in aggiunta alle nuove 
API esposte da Windows Mobile 5.0, rende 
estremamente rapido lo sviluppo di applica- 
zioni per dispositivi mobili, dando la possibi- 
lità a noi programmatori di creare applicazio- 
ni sempre più ricche e sempre più comode da 
usare. Ogni cosa però, va fatta sempre con 
moderazione. Usare i nuovi controlli come 
BindingSource anche quando non sono 
necessari, potrebbe rendere le applicazioni 
lente e scomode da usare, ottenendo di fatto il 
risultato opposto a quello per cui sono state 
create. Il compact framework è uno strumen- 
to veramente potente e flessibile. 
Probabilmente l'unico a consentire una 
modalità di sviluppo così rapida. Certamente 
la qualità dell'applicazione dipende dalle 
scelte effettuate in fase di design/ progettazio- 
ne, ma questa è una regola che vale sempre 
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E-COMMERCE 
FACILE IN JAVA 

IN QUESTO ARTICOLO MOSTRIAMO COME UTILIZZARE UNO DEI SERVIZI DI POS ELETTRONICO 
PIÙ FAMOSI E UTILIZZATI IN ITALIA: EASYNOLO SVILUPPATO DA BANCA SELLA. SCOPRIREMO 
CHE È SUFFICIENTE UNA MANCIATA DI CODICE E QUALCHE API PER RENDERE TUTTO SEMPLICE 




U CD □ WEB 

Ecommerce_facile_in_Java.zip 



nm 



30 




Quando vi recate in un negozio tradizionale 
ed effettuate un acquisto con la carta di cre- 
dito, normalmente avvengono le seguenti 
oni: 

• Fornite la vostra carta di credito alla gentile signo- 
ra alla cassa 

• Vi verrà chiesto un documento che certifichi la 
vostra identità 

• La carta di credito verrà "inserita" in un POS, che 
invierà la richiesta di pagamento al circuito pro- 
prietario della carta di credito 

• In qualche modo il circuito verificherà che la vostra 
carta disponga dei fondi necessari per effettuare il 
pagamento 

• Se la carta è valida ed ha sufficientemente credito 
il pagamento verrà erogato, altrimenti verrà nega- 
to 

• Se il pagamento è stato autorizzato verrà emesso 
uno scontrino sul quale apporrete una firma che 
autentica la vostra volontà di effettuare la transa- 
zione 

• Il circuito proprietario della carta di credito si 
occuperà di trasportare il denaro dal vostro con- 
corrente a quello dell'esercente 

I soggetti che in un qualche modo partecipano a 
questa operazione sono realmente tanti. 
Normalmente il commerciante dispone di un POS 
fornitogli dalla propria banca. Il POS è pre-program- 
mato per connettersi ai circuiti di verifica della carta 
e avviare la transazione. Ma nel caso del commercio 
elettronico, non esiste un POS pre-programmato in 
cui inserire la carta di credito. Quando si parla di e- 
commerce l'atto di inserire la carta nel POS sarà 
sostituito dall'inserimento dei dati relativi alla carta 
di credito all'interno di una Form. La banca non for- 
nirà più all'esercente una macchina fisica in cui stri- 
sciare la carta, ma una serie di API/ Servizi che 
dovranno essere richiamati all'atto della pressione 
del tasto "Invio" relativo alla form contenente i dati 
della carta di credito. GestPay è appunto un'insieme 
di API/Servizi resi disponibili da Banca Sella per la 
creazione di un POS virtuale. 



CARATTERISTICHE 
DI GESTPAY 

Il servizio di GestPay è diviso in due sezioni distinte. 
La prima sezione è costituita da una serie di compo- 
nenti e di script specifici resi disponibile da Banca 
Sella, e da installare sul server che ospita il sito del- 
l'esercente. La seconda sezione è costituita da un'a- 
rea di BackOffice, ovvero un'area riservata messa a 
disposizione da Banca Sella sul proprio sito, alla 
quale l'esercente può accedere per visualizzare i 
report delle transazioni, effettuare storni o altre ope- 
razioni tipiche di un esercizio commerciale. 
I componenti installati lato server espongono una 
serie di interfacce che il programmatore dovrà utiliz- 
zare per implementare il proprio servizio di POS. 
Saranno proprio questi componenti lato server che 
si occuperanno della trasmissione delle informazio- 
ni. Da un punto di vista strettamente tecnico, la tra- 
smissione avverà su base SSL3 a 128 bit, per ottene- 
re la massima sicurezza possibile. 
GestPay permett di avere diverse tipologie di inter- 
facce per il pagamento. Quella che vedremo in que- 
sto articolo è quella che viene denominata 
"Crittografia". 



CRITTOGRAFIA 

Questo metodo di pagamento segue un protocollo 
di sicurezza che si appoggia ad SSL. L'esercente 
reindirizza l'utente ad una pagina sicura di Banca 
Sella dove è possibile effettuare il pagamento. Se il 
pagamento viene eseguito in modo corretto, il 
controllo ritorna alle pagine del sito insieme ad un 
codice di risposta. 

All'esercente non resta che verificare il codice di 
risposta, e dare il via alla catena di spedizione della 
merce se il pagamento risulta confermato, vicever- 
sa intraprendere altre azioni, se il pagamento non 
risulta confermato. 

Uno schema di funzionanento del metodo di 
pagamento con crittografia è proposto in [[Figura 
1]] L'utente inizia la comunicazione con il server 
dell'esercente. Molto probabilmente inserirà in un 
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dura di pagamento. 



Fig. 1: L'architettura dei sistema di pagamento con 
Crittografia 

carrello elettronico i prodotti che desidera com- 
prare. Quando l'utente decide di effettuare il paga- 
mento il server contatterà per la prima volta 
GestPay. Utilizzando una classe Java, che analizze- 
remo in dettaglio a brevissimo. Il server richiederà 
al componente Java di cifrare i dati della transazio- 
ne e tenterà un collegamento al circuito o GestPay. 
Quest'ultimo identificherà il nostro server e se lo 
riconoscerà autorizzato invierà una risposta. A 
questo punto potremo reindirizzare l'utente verso 
FURL di pagamento di Banca Sella, passandogli 
come parametri quelli che ci sono stati forniti 
nella risposta da GestPay. L'utente effettua il paga- 
mento inserendo il numero di carta di credito. 
Dopo di ciò GestPay comunica al nostro server e 
all'utente il risultato della transazione. Il nostro 
server viene contattato su una pagina dedicata, 
dove viene passato il risultato della transazione in 
maniera criptata. Questa informazione deve esse- 
re decriptata utilizzando di nuovo la classe Java di 
cui abbiamo già parlato. L'esito della transazione 
viene ricevuto anche dall'utente, il quale viene 
reindirizzato al nostro server. In questo modo 
abbiamo un doppio controllo sulla transazione 
che viene effettuata. Rispetto all'esito della transa- 
zione avremo due diverse pagine, una per l'esito 
positivo e l'altro per l'esito negativo. Tutte queste 
informazioni devono essere inserite nel pannello 
di BackOffice di GestPay. 

Nel proseguio spiegheremo passo passo, proprio 
come realizzare questa serie di operazioni. 



FORM DI PAGAMENTO 

La prima cosa che dobbiamo fare è realizzare un 
form di pagamento, che ci consenta di effettuare 
l'interazione con il sistema di GestPay. In un siste- 
ma di produzione dovremmo anche inserire tutta 
una serie di informazioni riguardanti la sessione 
dell'utente, il numero di transazione, le informa- 
zioni sull'oggetto etc. etc. Per i nostri scopi didatti- 
ci ci limiteremo a creare un semplice form html 
che richiamerà una pagina JSP che inizia la proce- 



<pre> 



<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 

Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd"> 



<html> 



<head> 



<meta http-equiv="Content-Type" 

content="text/html; charset=UTF-8"> 



<title>Form di pagamento</title> 



</head> 



<body> 



<hl>Form di pagamento</hl> 



<form action="https://mioserver/pagamento.jsp"> 
<input name="myshoplogin" type="hidden" 

value="GESPAY33374"> 



<input name="mycurrency" type="hidden" 



value="242"> 



Inserisci l'importo 



<input type="text" name="importo" value=""> 



<br> 



<input type="submit" va I uè =" Procedi con il 

pagamento" name="submit"> 



</form> 



</body> 



</html> 



</pre> 

In questa pagina html non facciamo altro che invia- 
re ad una pagina JSP dei parametri hidden che 
riguardano l' identificativo ell'utente (myshoplogin) 
e la valuta utilizzata (242 per l'euro). Inoltre viene 
inviato un parametro contenente la cifra da pagare 
per eseguire l'acquisto. Nel momento in cui testate 
questo codice con un vostro utente chiaramente 
inserite cifre piccole, che comunque vi verranno 
solamente sottratte dal platfond della vostra carta di 
credito e restituite successivamente. 



RICHIESTA 

DI PAGAMENTO 

Passiamo ora alla definizione della pagina di paga- 
mento. Qui dovremo utilizzare l'oggetto GestPay 
CryptHS che viene reso disponibile per gli sviluppa- 
tori da EasyNolo. Praticamente passeremo a questo 
oggetto tutte le informazioni sulla nostra transazio- 
ne e ci verranno restituiti i parametri per comporre 
l'uri dove il nostro utente dovrà andare ad inserire le 
sue informazioni riservate. 

<pre> 

<%@page contentType="text/html"%> 

<%@page pageEncoding="UTF-8"%> 

<%@page import="criptGP.*"%> 

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 
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Transitional//EN" 



03) M 



"http://www.w3.org/TR/html4/loose.dtd"> 



<html> 



<head> 



<meta http-equiv="Content-Type" 

content="text/html; charset=UTF-8"> 



<title>Pagina di pagamento</title> 



</head> 



<body> 



<hl>Pagina di pagamento</hl> 



<% 



GestPayCryptHS objCrypt = new GestPayCryptHS(); 
String myshoplogin = 

request.getParameter("myshoplogin"); 
String mycurrency = 

request.getParameter("mycurrency"); 
String myamount = request.getParameter("importo"); 
String myshoptransactionlD = "1"; 
objCrypt.SetShopLogin(myshoplogin); 
objCrypt. SetCurrency(mycurrency); 
objCrypt.SetAmount(myamount); 
objCrypt.SetShopTransactionlD(myshoptransactionlD); 
//POSSIAMO ANCHE INSERIRE LE INFORMAZIONI 

// RIGUARDANTI L'UTENTE CHE ACQUISTA 

//QUESTE DEVONO ESSERE PREVENTIVAMENTE 

INSERITE 

// NEL BACKOFFICE DI GESTPAY 

//QUINDI IN QUESTO SEMPLICE CASO NON LE 

//UTILIZZIAMO MA LE LASCIAMO COMMENTATE 
/* 



String mybuyeremail = "mario.rossi@isp.it"; 

String mylanguage = "1"; 

String mycustominfo = "C0DCLIENTE=1"; 

objCrypt.SetBuyerName(mybuyername); 

objCrypt.SetBuyerEmail(mybuyeremail); 

objCrypt.SetLanguage(mylanguage); 

objCrypt.SetCustomlnfo(mycustominfo); 

_V 

objCrypt. Encrypt(); 

String identificativo = ""; 

String loginCifrato = ""; 

if (objCrypt.GetErrorCode().equals("0")) { 

identificativo = objCrypt.GetEncryptedString(); 

loginCifrato = objCrypt.GetShopLoginQ; 



else { 

out.write ("GestPay Error"); 
out.write ("GestPay ErrorCode 

"+objCrypt.GetErrorCode()+" 
"+objCrypt.GetErrorDescription()); 



} 



%> 



<form 

action="https://ecomm. sella. it/gestpay/pagam.asp"> 
<input name="a" type="hidden" 

value="<%=loginCifrato%>"> 
<input name="b" type="hidden" 

value="<%=identificativo%>"> 
<input type="submit" va I uè =" Procedi con il 

pagamento" name="submit"> 



String mybuyername = "Mario Rossi"; 


</form> 






r£tf)n 


\V> 


^^ 
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QUANTO COSTA GESTPAY 


L'attivazione del servizio necessario poi corrispondere a come imposta di bollo. A tutto 
"Verified By Visa", che offre la Banca Sella il 3% sul valore ciò è necessario aggiungere un 
maggiore sicurezza in relazioni dell'acquisto. Per i non canone per l'uso del software, 
a tentativi di frode ha un costo correntisti di Banca Sella infine da ricavare identificandolo sulla 
di 400 . Per ogni transazione è c'è un costo di 14.62 € dovuto base della seguente tabella: 


Caratteristiche 


Basic 


Advanced Professional 


Abilitazione a tutti i sistemi di pagamento 


Si 


Si 


Si 


Support 
Yen, Dol 


d valuta: Euro, Sterlina Inglese, Dollaro, 
laro di Hong Kong, Real brasiliano. 


No 


Si 


Si 


Auto-Te! 


;t 


Si 


Si 


Si 


Tool di gestione del rischio 


No 


Si 


Si 


Abilitazi 


one a Verified by Visa 


Si 


Si 


Si 


Back-Ofl 


: ice in lingua italiana, inglese e spagnola 


Si 


Si 


Si 


Back-Office con gestione multi-utente 


Si 


Si 


Si 


Persona 


izzazione pagina di pagamento 


No 


Si 


Si 


Active R 


eport Light 


Si 


Si 


Si 


Active R 


eport Full 


No 


No 


Si 


Modulo 


Server To Server 


No 


No 


Si 


Visibilità 


su Shop in Sella.it 


Si 


Si 


Si 


Campag 


na pubblicitaria e banner su Shop in Sella.it 


No 


No 


Si 


Costo Mensile 


7,75 + iva 


12,91 +lva 


18,08 + Iva 

J 
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</body> 



</html> 



</pre> 

Come potete vedere il codice è abbastanza sempli- 
ce e intuitivo. Dopo che l'utente ha cliccato sul bot- 
tone della form html la nostra applicazione rimane 
in attesa, ovvero noi usciamo dal dialogo con l'u- 
tente, il quale parla direttamente con GestPay. 



L'AMBIENTE 
DI BACKOFFICE 

Abbiamo già detto che quando GestPay riceve 
la richiesta di connessione deve identificare il 
server richiedente come valido. Per tale moti- 
vo l'esercente deve configurare nel proprio 
ambiente di Back-Office l'indirizzo IP del ser- 
ver che effettuerà le richieste. 




Fig. 2: Configurazione IP 

Allo stesso modo devono essere segnalate le 
pagine che devono ricevere l'esito della rispo- 
sta. È necessario configurare sia una pagina 
per esiti positivi sia una pagina per esiti posi- 
tivi. 
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Fig. 3: Configurazione pagine di risposta 

Le pagine di risposta sarsanno presenti sul 
server dell'esercente e dovranno contenere il 
codice necessario a gestire la transazione sia 
in caso di risposta positiva sia in caso di rispo- 
sta negativa 



PAGINA DI PAGAMENTO 

Dopo aver cliccato sul bottone della form html 
l'utente visualizza con il browser il pagamento 
online di BancaSella. Questo pagamento prevede la 
possibilità di utilizzare carte di credito differenti e 
ticket prepagati. Dopo aver inserito i dati vengono 
chieste le classiche conferme e infine si viene 
ridirezionati sul nostro server. 
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Fig. 4: Il pagamento che l'utente visualizza con il 
browser 



PAGINA DI RISPOSTA 

In questo esempio utilizziamo una sola pagina di 
risposta, la quale scriverà semplicemente in output 
tutti i dati restituiti dalla transazione. Anche in que- 
sto caso utilizziamo la classe GestPayCryptHS per 
decripta i dati che ci vengono inviati. 

<pre> 

<%@page contentType="text/html"%> 
<%@page pageEncoding="UTF-8"%> 
<%@page import="criptGP.*"%> 
<html> 
<head> 

<meta http-equiv="Content-Type" 

content="text/html; charset=UTF-8"> 

<title>RISPOSTA DEL PAGAMENTO 

</title> 

</head> 

<body> 

<hl>Reply Page</hl> 

PAGINA PER LA GESTIONE DELLA RISPOSTA DI 

PAGAMENTO 

<% 

String 
shoptrxID,buyemame,buyeremail,trxresult,authcode 
errorcode^rrordescription^anktrxid^alertcode^alert 

escription,custominfo; 
String parametro_a = request.getParameter("a"); 
String parametro_b = request.getParameter("b"); 
parametro_a = parametro_a.trim(); 
parametro_b = parametro_b.trim(); 
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GestPayCryptHS objdeCrypt = new 

GestPayCryptHS(); 


objdeCrypt. SetShopLogin(parametro_a); 


objdeCrypt. SetEncryptedString(parametro_b); 


objdeCrypt. Decrypt() ; 


String ErrorCode=objCrypt.GetErrorCode(); 


String shoplogin = 

objdeCrypt. GetShopl_ogin().trim(); 


int currency = 

Integer.parselnt(objdeCrypt.GetCurrencyO); 


Float amount = new 

Float(objdeCrypt.GetAmount()); 


String shoptrxID = 

objdeCrypt. GetShopTransactionID().trim(); 


String buyername = 

objdeCrypt. GetBuyerName().trim(); 


String buyeremail = 

objdeCrypt. GetBuyerEmail().trim(); 


String trxresult = 

objdeCrypt. GetTransactionResult().trim(); 


String authcode = 

objdeCrypt. GetAuthorizationCode(); 


String errorcode = objdeCrypt. GetErrorCode(); 


String errordescription = 

objdeCrypt. GetErrorDescription().trim(); 


String banktrxid = 

objdeCrypt. GetBankTransactionID().trim(); 


String alertcode = 

objdeCrypt. GetAlertCode().tnm(); 


String alertdescription = 

objdeCrypt. GetAlertDescription().trim(); 


String custominfo = 

objdeCrypt. GetCustomInfo().trim(); 


out.write("ID di transazione del negozio 

"+shoptrxID+"<br>"); 


out.write("Importo "+amount+"<br>"); 


out.write("Nome del compratore 

"+buyemame+"<br>"); 


out.write("Email del compratore 

"+buyeremail+"<br>"); 


out.write("Risultato della transazione 

"+trxresult+"<br>"); 


out.write("Codice di autorizzazione 

"+authcode+"<br>"); 


out.write("Codice d'errore "+errorcode+"<br>"); 


out.write("Descrizione dell'errore 

"+errordescription+"<br>"); 


out.write("ID di transazione della banca 

"+banktrxid+"<br>"); 


out.write("Codice di Alert "+alertcode+"<br>"); 


out.write("Descrizione dell'Alert 

"+alertdescription+"<br>"); 


out.write("Custom info "+custominfo+"<br>"); 


System. out.println("RICHIESTA DA 

"+request.getRemoteHost()); 


%> 


</body> 


</html> 



</pre> 

Come potete vedere utilizziamo anche in questo 
caso un package criptGP. Questo è stato definito 
per questo esempio, inserendo il codice sorgente 
che viene fornito della classe GestPayCryptHS. 
Questo viene fatto soltanto per poter distribuire 
l'applicazione con un solo pacchetto war e per 
poter definire un nostro package che possiamo 
ampliare con ulteriori classi riguardanti la sicurez- 
za del nostro sito. Insieme alla visualizzazione di 
questa pagina abbiamo come risultato finale 
anche l'invio di email all'utente e all'amministra- 
tore del sito per la segnalazione della transazione. 
Nell'ambiente di test che viene fornito possiamo 
cancellare la transazione utilizzando il menu 
Active Report -> Report. Oltre alla configurazione 
del sistema, nell'ambiente di BackOffice troviamo 
anche una reportistica per il nostro sito di ecom- 
merce, utile per controllare la situazione generale. 



OTP 

GestPay fornisce anche un altro metodo di paga- 
mento differente da "Crittografia". Questo si basa 
sulla generazione di OTP (One Time Password). 
Praticamente dal BackOffice viene richiesta la gene- 
razione di un certo numero di password. Quando la 
generazione è completata ci viene segnalato tramite 
email e possiamo procedere all'attivazione e il 
download di queste password. Di volta in volta uti- 
lizzeremo queste password nel nostro sito, conside- 
rando che valgono per una sola transazione e che 
una volta finite dovremo provvedere manualmente 
all' aggiornamento. 



CONCLUSIONI 

Il sistema di pagamento che viene fornito da 
Banca Sella permette di costruire il modulo di 
pagamento del nostro sito di e-commerce in una 
maniera abbastanza semplice. In questo modo 
infatti possiamo agevolmente creare un modulo di 
pagamento che viene integrato nel nostro sistema, 
fornendo all'utente un pratico pagamento con 
carta di credito. In Italia quasi tutti le banche for- 
niscono sistemi di pagamento virtuale. Il metodo 
generale è quasi sempre molto simile a quello pro- 
posto in questo articolo, a cambiare sono ovvia- 
mente le interfacce esposte dai vari componenti. 
In ogni caso se avete un cliente che desidera apri- 
re un negozio online è sempre opportuno chiede- 
re alla propria banca quali sono i servizi offerti. 
Molto spesso si ottengono condizioni personaliz- 
zate adeguate ai propri volumi di traffico 

Federico Paparoni 
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CLASSI AL VOLO CON 
IL CODICE DINAMICO 

LA VERSIONE 2.0 DI .NET È TALMENTE PERSONALIZZABILE CHE L'INTERO 
COMPILATORE È ESPOSTO IN CLASSI. QUESTA CARATTERISTICA PUÒ ESSERE 
SFRUTTATA PER FAR GESTIRE A CLASSI SPECIALI FILE PARTICOLARI... 




BuildProviders.zip 



WEB 



^ 




Tempo di realizzazione 



Diciamo subito che parlare di Build Providers 
non è esattamente cosa semplice. Allora 
prima di entrare nel merito della teoria, è il 
caso di iniziare con un sempio che ci chiarirà meglio 
le idee su quello che ci attende. I passi che intendia- 
mo eseguire sono i seguenti: 

• Disponiamo di uno o più file XML rinominati con 
estensione .iop e contenuti nella directory 
"APP_CODE" di un progetto ASRNET 

• Un template per i file in questione potrebbe esse- 
re il seguente: 

<greetings title="greetl"> Hello World </greetings> 

• desideriamo che quando l'applicazione viene 
lanciata, tutti i file contenuti nella directory 
APP_CODE e con estensione .iop vengano parse- 
rizzati. 

• Per ogni file parserizzato deve essere generata 
"dinamicamente" una classe che possiamo 
instanziare all'interno della Web Application. 

Questo ci consente di non dover creare fisicamente 
i file delle classi all'interno del progetto, ma di poter- 
le instanziare dinamicamente. Come fare? 
Iniziamo con il creare una nuova soluzione dotata di 
un progetto "Class Library" in C#. Aggiungiamo un 
riferimento a "System.Web" e scriviamo la nostra 
classe come segue: 







using System; 


using System. Collections.Generic; 


using System. Text; 


using System.Web; 


using System. Web. Compilation; 


using System. CodeDom; 


using System. Xml; 


using System. IO; 
namespace iopBuildProvider 
{ 


public class iopBuilder: BuildProvider 


{ 


private XmlDocument IOPDocument; 



private XmlDocument LoadDocument() 

J 

if (this. IOPDocument == nuli) 

{ 

using (Stream stream = this.OpenStream()) 

{ 

XmlDocument iopDocument = new 

XmlDocumentO; 
iopDocument.Load(stream); 
IOPDocument = iopDocument; 



} 

return this. IOPDocument; 

_} 

private string Title 

J 

get 



XmlDocument iopDocument = 

this.LoadDocument(); 
XmlNode n = 

iopDocument.SelectSingleNode("/greetings"); 
return n.Attributes["title"].Value; 



} 



} 



public override void GenerateCode(AssemblyBuilder 

assemblyBuilder) 



{ 



CodeTypeDeclaration myType = new 

CodeTypeDeclaration(Title); 
CodeMemberMethod myMethod = new 

CodeMemberMethodQ; 



myMethod. Name = MyMethod; 



myMethod. ReturnType = new 

CodeTypeReference(typeof( String)); 



} 



Aggiungiamo un Web Site al progetto, e modifichia- 
mo il web.config aggiungendo le seguenti righe: 

compilation debug="true" defaultLanguage="C#"> 
<buildProviders> 
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<add extension=".iop" type="iopBuildProvider.iopBuilder, 

iopBuildProvider"/> 
</buildProviders> 



</compilation> 



Nela directory APP_CODE aggiungiamo un file 

progetto. iop contenente: 
<greetings title="greetl">Hello World</greetings> 
Instanziamo la nuova classe come segue: 



<script runat="server"> 



void Page_Load(object sender, EventArgs e) 



{ 



greetl g = new greetlQ; 



} 



</script> 

Cosa abbiamo fatto? Modificando il web.config 
abbiamo fatto in modo che tutti i file con estensione 
iop presenti in APP_CODE vengano gestiti dalla 
libreria ioPbuilder. ioPbuilder contiene un Build 
Provider che attraverso il metodo GenerateCode 
compila in C# la nuova classe e la rende disponibile 
all'applicazione. Ovviamente per ottenere la classe 
in VB sarebbe sufficiente semplicemente cambiare il 
parametro nel web.config. 



DALLA PRATICA 
ALLA TEORIA 

Dovrebbe essere chiaro che un build provider è 
essenzialmente questo: un generatore e compilato- 
re di codice. D'altra parte il nome è abbastanza 
esplicativo e ci aiuta anche nel restringerne l'area di 
utilizzo. Un build provider, infatti, è legato ad un 
particolare tipo di risorsa ed anzi agisce proprio in 
base all'estensione. Ecco perché un file con esten- 
sione .aspx ci restituisce una pagina, o quelli con 
estensione .Master ci consentono di avere una clas- 
se che rappresenti una Master Page: sono i build 
providers, in maniera del tutto automatica, a farlo 
per noi, proprio come nel caso della compilazione 
delle pagine (del cui ciclo in realtà fanno parte). 
Non è certo argomento semplice da padroneggiare, 
ma i concetti sono semplici: ci sono delle classi che 
"leggono" il contenuto di alcuni file e "traducono" 
questo contenuto in codice, che poi viene compila- 
to, come qualsiasi altra cosa all'interno di ASRNET. 
Prendiamo come esempio una pagina basata sul 
CodeFile (cioè con il codice separato dal markup). 
Sarà composta da un primo file, qualcosa così: 

<%@ Page language="C#" CodeFile="Test.aspx.cs" 

Inherits="Test" %> 
Questa è una <asp: Label runat="server" id="labell" 

Text="label" /> 

Ed un secondo che invece è il codice server- side 
vero e proprio: 



public 


partial class Test : System. Web. UI. Page { 


protected void Page_Load(object sender, 


EventArgs e) 


{ 


labell.Text="label"; 


} 


} 




In realtà quando richiamiamo la nostra pagina 
test. aspx, ASPNET produrrà una classe che avrà 
all'incirca questo contenuto, dal nome app_web*.cs, 
dove * indica una variante univoca all'interno del- 
l'applicazione, per evitare conflitti: 

public partial class Test : { 
protected 

global: :System. Web. Ul.WebControls. Label labell; 

_} 

public class test_aspx : global ::Test { 

private global: : System. Web. Ul.WebControls. Label 

_BuildControllabell() { ... } 

private void BuildControlTree(test_aspx etri) 




{- } 
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} 



In pratica verranno unite le due classi, laddove il 
markup, da insieme di testo HTML e dichiarazione 
di controlli, diventa invece una serie di definizioni 
ed istanze di controlli, con tanto di proprietà impo- 
state secondo il nostro codice originale, che poi sarà 
compilato sfruttando il linguaggio con in quale 
abbiamo deciso di scrivere la nostra applicazione. 



COME FUNZIONA UHI 
BUILD PROVIDER 

Un build provider internamente non fa altro che 
generare codice, come abbiamo ormai capito. In 
pratica, spesso un build provider ha un proprio 
sistema di analisi del codice sorgente, che provvede 



METTERE I FILE IN QUALSIASI DIRECTORY 



Il manager dei build providers 
crea un assembly per ogni 
directory, quindi le classi dei 
nostri file .aspx (o di qualsiasi 
altro tipo) finiscono tutte insieme 
e si vedono tra di loro, come se 
fossero normalissimi oggetti 
creati "manualmente". Se per 
questo si vuole utilizzare per 
esempio il nostro build provider 
di file Excel posizionandoli in 
un'altra directory, allora bisogna 
referenziare il percorso nella 
pagina. 
Per farlo basta aggiungere 



questa direttiva alla pagina 
ASP.NET: 

<%@ Refe re n ce 

virtualPath = "cartella/file. xls" %> 

In questo modo viene aggiunto 
il riferimento all'assembly 
corrispondente creato attraverso 
il nostro build provider. Questo 
problema non c'è per la 
directory /app_code/ perché è 
automaticamente referenziata 
da ogni risorsa. 
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INFORMAZIONI 
SU CODEGONI 

Potete trovare 

ulteriore 

documentazione su 

CodeDOM su MSDN, a 

questi indirizzi: 

http://msdn.microsoft.com 

/library/enus/cpgenref/ht 

ml/cpconCodeDOMQuick 

Reference.asp 

http://msdn.microsoft.com 

/library/enus/cpgenref/ht 

ml/cpconCodeDOMQuick 

Reference.asp 



a tradurre poi in qualcosa che il .NET Framework, su 
cui si base ASRNET, possa interpretare. Una caratte- 
ristica del .NET Framework è infatti proprio quella 
di essere indipendente dal linguaggio, grazie al fatto 
che in realtà si basa su IL (Intermediate Language). 
E proprio per preservare questa caratterista, si sfrut- 
ta quello che in gergo è chiamato CodeDOM. Come 
il nome suggerisce, analogamente a XMLDOM o 
Javascript DOM, è un insieme di funzionalità che 
servono a gestire codice. 

Una di queste consente funzionalità di generarlo, 
per l'appunto, indipendentemente dal linguaggio 
prescelto. Torniamo ancora una volta all'esempio 
della nostra pagina. Come sappiamo, è possibile 
scriverle in uno qualsiasi dei linguaggi supportati 
dal .NET Framework. Insomma spesso una pagina è 
scritta in C#, ma tante altre volte lo è in VB 2005. Ed 
un build provider deve essere egualmente capace di 
generare codice, altrimenti poi la classe che viene 
creata sarebbe composta da codice scritto in lin- 
guaggi diversi, e pertanto non sarebbe compilabile. 
È proprio in questo scenario che CodeDOM garanti- 
sce una generazione del codice indipendente dal 
linguaggio della nostra applicazione. 



GENERARE CODICE: 
IL CODEDOM 

Dunque CodeDOM risponde a questa necessità, 
consentendoci di concentrarci sulle funzioni di 
generazione del codice, più che sul codice derivante 
dal risultato finale. 

Il concetto è che dobbiamo scrivere codice per 
generare codice, secondo la logica del nostro build 
provider. 

Per esempio, questo è il codice in C# necessario per 
generare una classe di nome MyClass con un meto- 
do che restituisce una stringa, di nome MyMethod: 

CodeTypeDeclaration myType = new 

CodeTypeDeclaration("MyClass"); 
CodeMemberMethod myMethod = new 

CodeMemberMethod(); 
myMethod. Name = "MyMethod"; 
myMethod. ReturnType = new 

CodeTypeReference(typeof(String)); 

E questo è il relativo codice che sarà generato in C#: 

public class MyClass 

{ 

public String MyMethod() 

{ 



Ma dalla stesso codice di partenza, scritto in C#, 



avremo questa classe in VB 2005: 

Public Class MyClass 



Public Function MyMethodQ As String 



End Function 



End Class 

Il CodeDOM è implementato attraverso una serie di 
oggetti che si trovano nel namespace 
System.CodeDom. Il modello ad oggetti fornito ci 
consente praticamente di "descrivere" una classe in 
modo ricco e senza rinunciare a nessuna delle carat- 
teristiche che avremmo scrivendo direttamente il 
codice. 

Come già detto è un modo di generare codice indi- 
pendente dal linguaggio, che si basa quindi su quel- 
le che sono le caratteristiche di IL e che soprattutto 
sfrutta generatori di codice già pronti, basati sull'in- 
terfaccia ICodeGenerator. 

Il vantaggio di CodeDOM è che si può generare 
codice in qualsiasi linguaggio supporti le specifiche, 
si può compilarlo ed eseguirlo, tutto a runtime, 
senza avere fisicamente un oggetto disponibile su 
disco. Nel namespace troviamo il supporto per 
quasi tutti i costrutti di programmazione: dichiara- 
zioni, istruzioni, cicli, conversioni, array, commenti, 
gestione degli errori. Ma ci sono anche delle man- 
canze, che però possono essere superate utilizzando 
le classi Snippet. 

Il concetto è simile ai controlli literal di ASRNET: in 
pratica, possiamo specificare del codice da compila- 
re direttamente. Esistono diversi tipi di snippet: 
CodeSnippetCompileUnit, CodeSnippet 
Expression, CodeSnippetStatement e 
CodeSnippetTypeMember, questo per rendere pos- 
sibile ogni tipologia di scenario. 
Tuttavia la limitazioni che ci sono non rappresenta- 
no grosse problematiche, perché sono comunque 
facilmente aggirabili. Non è ad esempio possibile 
dichiarare l' alias di un namespace, che non possono 
nemmeno essere annidati, così come non è possibi- 
le dichiarare variabili di uno stesso tipo tutte insie- 
me e non è possibile utilizzare il modifier "unsafe" 
in C#, per dichiarare in questo modo un metodo. 
Per meglio orientarvi in quello che potete fare, nella 
tabella a fianco è incluso l'elenco completo delle 
classi con relativa spiegazione. 
Oltre dai build provider, CodeDOM è utilizzato da 
tool come WSDL.exe o XSD.exe, che se avete mai 
usato, saprete certamente che hanno la caratteristi- 
ca di generare codice (nel linguaggio che preferia- 
mo) partendo da uno schema, rispettivamente un 
Web Service o uno schema XML. 
Difatti il motivo per cui uno potrebbe aver bisogno 
di un build provider personalizzato è proprio quello 
di utilizzare un proprio formato di definizione ed 
avere invece accesso in maniera tipizzata agli ogget- 
ti risultanti. 
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CREARE UIU 
BUILD PROVIDER 

I tipici esempi sono quello di definire classi attraver- 
so una sintassi XML, creare dei ORM (Object 
Relational Mapper) semplificati, dove si ha una cor- 
rispondenza tra modello ad oggetti risultante e 
struttura del database. Piuttosto che accedere in 
maniera tipizzata alle proprietà del web.config o al 
contenuto di un file in formato Excel, o a qualsiasi 
altra cosa vi passi per la testa. Il cuore di tutto, in 
ogni caso, sarà proprio il Build Provider, che con 
l'uso del CodeDOM andrà a generare il codice. 
Per il nostro esempio ci baseremo su un build provi- 
der creato da Cristian Civera, disponibile anche nel 
ed allegato alla rivista, facilmente estendibile, che 
ha il vantaggio di darci accesso in maniera del tutto 
strongly typed a qualsiasi sheet di qualsiasi docu- 
mento Excel, semplicemente copiandolo nella 
directory /App_Code/, come potete notare in que- 
sto screenshot, con l'Intellisense di VS 2005 che è in 
grado di farci accedere allo stesso come se stessimo 
usando un oggetto qualsiasi: 



imm* 






m 






fig.l si noti il funzionamento dell'intellisense 



Come si può notare viene creato al volo un 
namespace Excel, all'interno del quale saranno 
costruiti in fase di esecuzione, sfruttando 
CodeDOM, le istanze di tutti i file e dei relativi 
worksheet, così da poter accedere in maniera 
strongly typed a questi ultimi. Analizzando il 
metodo GenerateCatalog della classe 
ExcelBuildProvider si potrà notare come viene 
utilizzato il CodeDOM in scenari reali: ci sono 
molte chiamate ed il codice è tutt' altro che bana- 
le, ma il risultato è ovviamente quello di creare, a 
tutti gli effetti, classi al volo, leggendone la strut- 
tura da sorgenti esterni, nel nostro caso un foglio 
Excel. Il tutto è fatto derivando dalla classe base 
BuildProvider, da cui tutti i build provider ovvia- 
mente derivano. Se andiamo a dare un'occhiata 
al contenuto della \v2.0.50727\Temporary 
ASP.NET Files\, scegliendo la directory con il 
nome della nostra applicazione, noteremo una 



directory di nome Sources_App _Code all'inter- 
no della quale sono stati savlati i file autogenera- 
ti dal nostro BuildProvider (ma è necessario 
tenere in debug l'applicazione perché siano pre- 
senti i sorgenti). E se facciamo attenzione, note- 
remo che all'interno del file c'è proprio uno dei 
commenti che abbiamo scritto sfruttando la 
classe CodeCommentStatement! 



UTILIZZARE 

UM BUILDPROVIDER 

La parte più semplice è davvero quella di utilizzare il 
build provider. Perché ASPNET (e VS 2005) possa 
utilizzarlo, è sufficiente provvedere alla registrazio- 
ne, sfruttando la sezione \configuration\ 
system.web\compilation\ buildProvider, in questo 
modo: 

<configuration> 

< system, web > 

compilation defaultl_anguage="C#"> 

<buildProviders> 

<add extension=".xls" 

type="ASPItalia. com. BuildProviders. 
ExcelBuildProvider, ExcelBuildProvider"/> 
</buildProviders> 
</compilation> 
</system.web> 
</configuration> 

Da questo momento in poi, ogni file .xls (esten- 
sione specificata attraverso la proprietà exten- 
sion) invocherà la classe ExcelBuild. Provider, che 
essendo quella che abbiamo appena creato, 
prowederà prima a creare attraverso il 
CodeDOM il codice nel linguaggio (nel nostro 
caso C#, ma provate a cambiare l'attributo 
defaultLanguage del tag compilation e notate la 
differenza. . .) e poi a compilarlo in un oggetto, da 
utilizzare all'interno delle nostre applicazioni. Ci 
basta aggiungere un file Excel per avere accesso 
nello stesso modo, senza fare nient' altro, alle 
relative informazioni. Provare per credere! 



CONCLUSIONI 

L'architettura di HttpRuntime in ASPNET 2.0 è 
profondamente differente e consente molta più 
estendibilità rispetto alla versione 1.1. I build 
provider ne sono un ottimo esempio e consento- 
no di costruire funzionalità sfruttando strutture 
più semplici, come file XML, o anche più com- 
plesse, come database. Ancora una volta, l'unico 
limite è nella nostra fantasia! 

Daniele Bochicchio 
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LOGIN PROTETTO CON 
IMMAGINI CAPTCHA 

VI È MAI CAPITATO DI DOVER RIPORTARE IL TESTO RAPPRESENTATO IN UN'IMMAGINE 
ALL'INTERNO DI UNA FORM, PER POTER EFFETTUARE LA REGISTRAZIONE A UN SITO 
WEB? ECCO COME POTETE IMPLEMENTARE QUESTA FUNZIONE NEI VOSTRI SITI 




REQUISITI 



Conoscenze richieste 




l JDK 1.4 (o successivi), 
Tomcat, Axis 1.3, 
JCaptcha 



IB9! 



La maggioranza dei siti Web offrono la possibi- 
lità di registrarsi, al fine di ottenere uriidentifi- 
bazione per usuffruire dei servizi esposti: 
forum, wiki, blog, etc. I dati di registrazione vengono 
forniti attraverso form Web. Recentemente però gli 
spammer hanno creato dei bot che scansionano la 
rete alla caccia di pagine di registrazione, e quando 
ne trovano eseguono una registrazione fasulla, con 
fini non proprio leciti. Per proteggersi da questo tipo 
di attacco, un buon metodo è quello di usare 
"immagini captcha". Si tratta di un'immagine gene- 
rata in maniera random e contenente una stringa o 
un codice. L'unico modo per validare la registrazio- 
ne è quello di riportare il contenuto dell'immagine 
in un campo di confronto, operazione che può esse- 
re fatta solo manualmente dall'utente. Difficilmente 
un bot sarebbe in grado di analizzare il contenuto 
dell'immagine e riempire il campo di confronto. 
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Fig. 1: La pagina di registrazione di un nuovo 
account in Yahoo e l'immagine con il testo "distorto" 

Nel 2000 alcuni autori, della Carnegie Mellon 
University, hanno proposto il termine CAPTCHA 
(Completely Automated Public Turing test to teli 
Computers and Humans Apart) per designare tutti 
quei metodi che prevedono la generazione random 
di un oggetto e la conseguente validazione basata 
sulla sull'interpretazione dell'oggetto (infatti si 
potrebbe pensare a metodi alternativi alla genera- 
zione di immagini quali suoni o altre forme di 
comunicazione). 



Lo scopo dell'articolo è generare immagini CAPT- 
CHA e renderle disponibili attraverso un Web 
Service scritto in Java. Per farlo si useranno alcuni 
progetti open source (in particolare JCaptcha, Axis) 
e si mostrerà come utilizzare il servizio in alcune 
pagine Web. 



INSTALLARE 

ED USARE JCAPTCHA 

Esistono molti progetti Open Source nati con l'in- 
tento di realizzare framework per la generazione di 
immagini CAPTCHA. In ambiente Java uno dei pro- 
getti più interessanti è JCaptcha (sito di riferimento 
http://www.jcaptcha.net ). 

Per prima cosa è necessario eseguire il download del 
progetto (va bene il progetto in forma binaria, ovve- 
ro già compilato: jcaptcha-bin-1.0-RC2.0.1.zip). Per 
installarolo è sufficiente prendere il file jar contenu- 
to nell'archivio compresso e inserirlo nel classpath 
prima di compilare il proprio progetto. Il nostro 
esempio è stato sviluppatp usando Eclipse, ma va 
bene un qualsiasi editor, IDE o semplice compilato- 
re!. Va anche fatto il download del file ehcache- 
1.2.jar dal sito http://ehcache.sourceforge.net/ 
(esso viene utilizzato internamente da JCaptcha) e 
posto nel classpath del progetto. 



GENERARE LE IMMAGINI 

La classe com.octo.captcha.service.image.Defa- 
ultManageablelmageCaptchaService permette di 
reperire un servizio per la creazione di nuove 
immagini (servizio con parametri di default; è 
anche possibile creare servizi personalizzati 
impostando le caratteristiche di creazione delle 
immagini, come font da usare, colori, alfabeto 
per i caratteri e così via). È importante accedere 
ad un'unica istanza del servizio, ovvero usare un 
pattern come il Singleton. Ecco un esempio di 
classe che realizza un singleton e che restituisce 
il servizio di default: 
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public class ServiceSingleton { 



private static ImageCaptchaService instance = 
new DefaultManageablelmageCaptchaServiceQ; 



public static ImageCaptchaService getlnstance() { 
return instance; 



} 



Tale servizio ha un metodo {getlmageChallenge 
ForID) che permette di generare una nuova immagi- 
ne e di associarla ad un identificativo univoco. Ecco, 
per esempio, come sfruttare il servizio per generare 
una nuova immagine (l'identificativo, in questo 
caso, viene passato come parametro): 

public static byte[] getImage(String captchald) { 
ByteArrayOutputStream jpegOutputStream = new 
ByteArrayOutputStream(); 

try{ 

Bufferedlmage challenge = ServiceSingleton 
.getlnstance() 

.getlmageChallengeForlD(captchald); 
JPEGImageEncoder jpegEncoder = JPEGCodec 

.createJPEGEncoder(jpegOutputStream); 
jpegEncoder.encode(challenge); 
} catch (Exception e) { 
return nuli; 

_} 

return jpegOutputStream. toByteArray(); 



Il metodo si occupa anche di generare un array di 
byte che rappresentano l'immagine secondo la 
codifica JPEG. Dallo stesso servizio è possibile veri- 
ficare se una risposta è corretta per l'immagine 
usando il metodo validateResponseForID (in questo 
caso i parametri sono due: l'identificativo con cui è 
stata generata l'immagine e la risposta inserita dal- 
l'utente; quest'ultima viene memorizzata come 
stringa di caratteri): 

public static boolean isCorrect(String id, 

String tryResponse){ 
return 

ServiceSingleton. getInstance().validateResponseForI 

D(id, tryResponse); 
} 

Questi due metodi sono, nell'esempio proposto, 
inseriti nella classe ImageUtility e, da soli, sono suf- 
ficienti a "comandare" JCaptcha per la generazione 
delle immagini e il test sul valore inserito. La classe 
ImageUtility ha anche un metodo che permette di 
generare un nuovo identificativo univoco: 
getNextld. Come parametri accetta due stringhe che 
rappresentano, rispettivamente, uno username ed 
una password. Se essi sono tra le coppie ritenute 



valide allora viene generato l'ID, altrimenti viene 
restituito nuli (per i dettagli implementativi si faccia 
riferimento ai sorgenti della classe). 



CREARE IL WEB SERVICE 

Per creare il Web Service si utilizzerà Axis, nella ver- 
sione 1.3. Dopo aver scaricato la versione binaria del 
framework e averla scompattata, si prenda la cartel- 
la "axis" presente sotto "webapps" e la si copi nella 
cartella $CATALINA_HOME /webapps (dove per 
$CATALINA_HOME di intende la cartella dov'è 
installato Tomcat). 

Esiste un modo molto semplice per la generazione 
di un servizio: è sufficiente creare una classe Java 
che non appartenga ad alcun package e rinominare 
il file .java in .jws, quindi posizionarlo nella cartella 
della WebApp di Axis. Essa verrà compilata e resa 
disponibile come Web Service (affinché venga com- 
pilata è necessario che Tomcat contenga nel path il 
file tools.jar ed eventuali classi/ archivi di cui la clas- 
se fa uso). Se si vuole compilarla esternamente, 
basterà mettere il file .class nella cartella axis /WEB - 
INF/jwsClasses della WebApp Axis (anche in questo 
caso va comunque inserito il file .jws; semplicemen- 
te quest'ultimo non verrà compilato più da Tomcat). 

public class CaptchaWebService { 
public static String getl\lextId(String user, String 

mySecretWord){ 



return Imagelltility.getNextId(user, 



mySecretWord); 



> 



public byte[] getImage(String id) { 



return ImageUtility.getlmage(id); 



} 



public boolean isCorrect(String id, String 

tryResponse){ 
return ImageUtility.isCorrect(id, tryResponse); 



} 



> 



Ovviamente la classe ImageUtility, insieme ad altre 
classi usate, vanno copiate nella cartella axis /WEB - 
INF/classes, mentre i JAR (in questo caso quelli di 
JCaptcha) vanno posti in axis/WEB-INF/lib. 
Come si può osservare la classe non fa altro che 
esporre i metodi presenti nella classe ImageUtility. 
Perché, allora, non esporre direttamente quest'ulti- 
ma? Innanzi tutto essa appartiene ad un package 
{it. ioprogrammo. captcha) : eliminarlo potrebbe 
essere una soluzione per questo caso, ma così facen- 
do non si potrebbe usare la classe nelle JSP (per 
esempio). Insomma: molto meglio creare una nuova 
classe che è un semplice "wrapper" e lasciare disac- 
coppiata la realizzazione vera e proprio delle funzio- 
nalità. 





I TUOI APPUNTI 
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Per eseguire il test del servizio di può digitare l'uri a 
cui risponde (data dal nome, o indirizzo ip, dell'ho- 
st, la porta a cui risponde Tomcat, il nome della 
webapp di Axis più il nome del file .jws; per esempio: 
http://127.0.0.1:8080/axis/CaptchaWebService.j 
ws). Se tutto è andato a buon fine appare una pagi- 
na semplice semplice, con un link per ottenere il 
WSDL ("Click to see the WSDL", Figura 2). Il WSDL è, 
a tutti gli effetti, un descrittore che permette a 
chiunque (e in qualunque linguaggio!) di generare 
dei client che facciano uso del Web Service appena 
creato. 
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Fig. 3: II WSDL generato 



CREARE LE CLASSI PER 
ACCEDERE AL WS 

È possibile creare un client usando ancora Axis, 
ma è possibile farlo usando anche uno dei lin- 
guaggi della piattaforma .NET o PHP, Python, 
Perl o qualsivoglia altro linguaggio. Anche in 
questo caso i framework aiutano notevolmente 
la scrittura delle classi. Axis, per esempio, per- 
mette di generare in automatico tutte le classi 
che "incapsulano" la logica di interazione con il 
Web Service ed espongono il servizio remoto 
come chiamate a metodi locali. Per farlo è neces- 
sario settare il classpath in maniera che conten- 
ga tutte le lib del progetto, salvare il file WSDL e 
poi invocare il comando: 

java org.apache.axis.wsdl.WSDL2Java 

CaptchaWebService.wsdl 

Provando a generare le classi si nota che esse appar- 
tengono al package _1._0._0._127; questo può risul- 
tare sorprendente, ma è dovuto al fatto che il WSDL 
è stato scaricato da una uri che conteneva Tip della 
macchina locale. Per ovviare a questo problema si 
può eseguire lo stesso comando precedente ma con 
una nuova opzione:-p it.ioprogrammo.axis (nome 
del package). 

Benché sia semplice utilizzare anche la generazione 
usando direttamente le classi di Axis, esistono 
numerosi tool che integrano l'intero sviluppo all'in- 



terno dei più diffusi IDE; Eclipse possiede il plug-in 
WTP (Web Tools Project) che, tra le altre cose, gesti- 
sce la creazione di Web Services (sia lato server che 
lato client) usando Axis come framework. 



UNA WEBAPP 
COME CLIENT 

Non resta che usare le classi di accesso al WS in una 
applicazione. Per esempio si potrebbe creare un 
nuovo progetto web che mostri l'immagine e, trami- 
te una form, chieda all'utente di inserire il testo che 
legge in essa: 

<form name="my" action = "risultato.jsp" 
method = "post"> 

<% 

CaptchaWebServiceServiceLocator loc = 

new CaptchaWebServiceServicel_ocator(); 
CaptchaWebService_PortType ws = 

loc.getCaptchaWebService(); 
String id = ws.getNextId("user2", "qwertyuiop"); 

%> 

<input type="hidden" name="id_ws" 

value="<%= id %>" /> 
<input type="text" name="testo_random" /> 
<input type="submit" name="Avanti" /> 
</form> 



Il primo problema da affrontare è quello di decidere 
come l'immagine debba essere memorizzata; infatti 
essa dovrebbe venire creata dal WS, ma come la refe- 
renzia la pagina HTML? Ovviamente ci sono più 
possibili soluzioni: una è quella di richiedere l'im- 
magine al WS, salvarla sul file system e referenziarla 
dalla pagina HTML. In questo caso, essendo imma- 
gini "dinamiche" che non ha senso renderle persi- 
stenti una volta mostrata la pagina, si dovrebbe pre- 
vedere anche un meccanismo di eliminazione. 
Molto più semplicemente si potrebbe far sì che la 
pagina HTML referenzi sempre una uri specifica 
(per esempio immagini/random.jpg) ma a quella uri 
non corrisponde alcuna immagine sul file system 
ma ad essa risponde una servlet! In questo caso la 
servlet dovrebbe preoccuparsi di mandare sulla 
response l'immagine letta dal WS. Resta un proble- 
ma: come comunicare alla servlet l'ID a cui l'imma- 
gine si riferisce? Molto semplicemente si potrebbe 
usare un parametro sulla query string, per esempio 
immagini/random.jsp?id=valore. Ecco il codice da 
inserire nella pagina HTML che contiene la form 
mostrata in precedenza: 

<img src="immagini/random.jpg?id = <%= id %>" 
alt="Testo generato casualmente" /> 

Ecco, invece, la servlet che reperisce l'immagine dal 
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WS e la mette sulla request: 



public class ImageServIet extends HttpServIet { 
protected void doGet(HttpServletRequest request, 
HttpServIetResponse response) 
throws ServIetException, IOException { 
CaptchaWebServiceServiceLocator loc = new 

CaptchaWebServiceServicel_ocator(); 
CaptchaWebService_PortType ws=null; 
try { 

ws = loc.getCaptchaWebService(); 
} catch (ServiceException e) { 
e.printStackTrace(); 

_> 

String id = request. getParameter("id"); 

setResponseHeader(response); 

ServIetOutputStream responseOutStream 
= response. getOutputStream(); 

responseOutStream. write(ws.getlmage(id)); 

responseOutStream. flush(); 

responseOutStream. close(); 

_} 

} 



za della risposta: 



<% 



String id = request. getParameter("id_ws"); 



Boolean match = nuli 



try{ 



CaptchaWebServiceServiceLocator loc = 

new CaptchaWebServiceServicel_ocator(); 
CaptchaWebService_PortType ws = 

loc.getCaptchaWebService(); 
match = ws.isCorrect(id, 

request. getParameter("testo_random")); 
}catch(Exception e){ 
e.printStackTrace(); 

_} 

if (match! = null && match. booleanValue()) { 

%> 

Risposta corretta! 

<% 

} else { 

%> 

Risposta errata! 

<% 




Il metodo setResponseHeader non fa altro che impo- 
stare lo header http affinché non venga messa in 
cache la pagina e venga impostato il mime-type cor- 
retto: 



%> 



private void setResponseHeader( 


HttpServIetResponse response){ 


response. setHeader("Cache-Control", "no-store"); 


response. setHeader("Pragma", "no-cache"); 


response. setDateHeader("Expires", 0); 


response. setContentType("image/jpeg"); 


} 



In questo modo se l'utente esegue un back sul brow- 
ser, l'immagine viene comunque caricata nuova- 
mente (e diversa!). 

Ecco invece il mapping da inserire sul file WEB- 
INF/web.xml della webapp affinché la servlet 
risponda con l'immagine all'uri immagini/ran- 
dom.jpg: 

<servlet> 
<servlet-name>ImmagineRandom</servlet-name> 
<servlet-class> 
it.ioprogrammo.jcaptcha. ImageServIet 



</servlet-class> 



<load-on-startup>l</load-on-startup> 



</servlet> 



<servlet-mapping> 



<servlet-name>ImmagineRandom</servlet-name> 
< uri-pattern >/immagini/random.jpg</url-pattern> 



</servlet-mapping> 



Ecco la pagina risultato.jsp che verifica la correttez- 



Negli esempi allegati all'articolo questa seconda 
webapp si chiama CaptchaWsClient.war (in Figura 3 
l'esempio della sua esecuzione). 
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Fig. 4: II client di esempio 



CONCLUSIONI 

L'articolo ha mostrato con quanta semplicità sia 
possibile fornire un servizio Web a siti che neces- 
sitano di tecniche CAPTCHA. In realtà si potreb- 
be estendere ulteriormente l'esempio realizzan- 
do politiche di sicurezza più evolute (per esem- 
pio usando uno dei metodi proposti dallo stan- 
dard WS- Security). Inoltre potrebbe essere forni- 
to un servizio personalizzato affinché le immagi- 
ni generate possano provenire da un vocabola- 
rio, oppure con un set di caratteri personalizzato 
e così via. 

Ivan Venuti 
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SVILUPPO, MA GUARDARE A CONCETTI COME STANDARD E INTEROPERABILITÀ AL FINE DI 
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In una qualsiasi architettura SOA (Service - 
Oriented) esiste un provider di servizi ed 
un consumer che, comunicando tra di loro, 
si scambiano continuamente informazioni 
strutturate secondo protocolli standard come, 
ad esempio, SOAP. L'utilizzo dello standard 
SOAP, però molto spesso non è sufficiente per 
garantire la correttezza della comunicazione. 
In questo caso, come possiamo garantire cbe il 
consumer ed il provider "parlino la stessa lin- 
gua"? Lo scambio di informazioni, per essere 
interoperabile, deve rispettare delle regole che 
non appartengono strettamente ad una tecno- 
logia. Dobbiamo perciò definire i dati e gli 
schemi oggetto dei nostri servizi. Con questi 
presupposti nasce il concetto di "contratto". 
Nei Web Services tradizionali il contratto è 
generalmente costituito dal WSDL (Web 
Service Description Language), il cui compito è 
quello di descrivere ed esporre le caratteristi- 
che di un servizio, tra cui le operazioni consen- 
tite e i dati o schemi trattati, proprio al fine di 
permettere ai client la corretta implementazio- 
ne. In Windows Communication Foundation 
questo concetto viene rispettato pienamente e 
può essere implementato in diverse forme, 
ognuna con caratteristiche differenti e per 
questo adatta alle specifiche esigenze. 
Neil' articolo affronteremo lo sviluppo di un 
client che utilizza un servizio per ricercare libri 
su un database remoto. Per ottenere una 
comunicazione efficiente, sia il consumer, sia il 
servizio, implementeranno lo stesso contratto, 
stabilito e concordato preventivamente. 



I "CONTRATTI" DI WCF 

Prima di affrontare e risolvere lo scenario 
descritto, cerchiamo di capire quali strumenti 
Windows Communication Foundation propone 
e quali possono risultarci utili per affrontare le 
diverse problematiche. 
In Windows Communication Foundation defini- 



sce principalmente tre tipi di contratti: 

• Service Contracts: contiene l'indicazione i 
metodi, chiamati operation, ed i parametri 
che un client deve rispettare per comunicare 
con il servizio; 

• Data Contracts: è il tipo di contratto che defi- 
nisce gli schemi che rappresentano i tipi di 
dati scambiati tra le entità; 

• Message Contracts: consentono di lavorare 
direttamente sul messaggio SOAP, impostan- 
do le proprietà che appartengono all'header e 
quelle che appartengono al body; 

Ogni tipo di contratto assolve ad una funzione 
differente. Se la nostra esigenza è semplice- 
mente quella di definire le operazioni esposte, 
un concetto essenziale per un servizio, allora è 
sufficiente utilizzare il ServiceContract. Se, 
invece, abbiamo tutta l'intenzione di definire 
accuratamente le nostre entità, descrivendole 
sotto forma di schemi, allora dobbiamo utiliz- 
zare il DataContract . Le due tipologie erano 
già presenti nell'implementazione tradiziona- 
le, attraverso gli ASP.NET Web Service, utiliz- 
zando gli attributi WebService e WebMethods, 
per definire la classe di servizio e le sue opera- 
zioni, e la serializzazione, con l'utilizzo di 
XmlSerializer, per la definizione in schemi ed il 
controllo delle entità oggetto di scambio. Si 
aggiunge, ora, una nuova forma di contratto 
che permette di lavorare direttamente sul mes- 
saggio, modellandone le proprietà in modo da 
indirizzarle nell'header o nel body della busta 
SOAP a seconda delle esigenze: il Message 
Contract. 

Tutti i contratti vengono definiti sfruttando le 
potenzialità degli attributi. E' sufficiente deco- 
rare interfacce, classi, proprietà e metodi con 
gli appositi attributi, per ottenere il contratto 
desiderato. E' importante chiarire che le infor- 
mazioni indicate nei contratti trovano tutte 
una loro diretta corrispondenza nel WSDL, IL 
contratto che modella il nostro servizio. 
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IL SERVIZIO 
BOOKSEARCH 

In Windows Communication Foundation l'imple- 
mentazione di un servizio dipende direttamente 
dalla definizione del suo contratto. Il contratto, o 
WSDL, realizza la sua implementazione nello speci- 
fico linguaggio attraverso le interfacce. In C#, ad 
esempio, è possibile definire una interfaccia e deco- 
rarla con gli attributi ServiceContract e 
OperationContract per poi ottenere il contratto di 
un servizio. Proviamo a capire come funziona il 
meccanismo di definizione dei contratti creando 
una libreria di servizi. Apriamo, quindi, Visual 
Studio 2005 e creiamo un nuovo progetto Class 
Library. Qui aggiungiamo un file chiamato 
IBookSearch ed inseriamo il codice seguente: 



te creata ed inseriamo nella procedura di avvio 
Main il codice per esporre il servizio: 

// creo l'hosting del servizio 

ServiceHost host = new 

ServiceHost(typeof(l_ibrary.BookSearch)); 

// creo l'hosting del servizio 

host.AddServiceEndpoint(typeof(l_ibrary.IBookSearch), 




new basicHttpBindingQ, 



"http ://localhost: 900 1/BookSearch"); 



// apro il canale per mettere in ascolto il servizio 



host.OpenQ; 



// attendo che arrivino le richieste 



Console. ReadLineQ; 



// chiudo il canale 



host.CloseQ; 



[ServiceContract(Namespace="http:// 

www.ioprogrammo.it/2006/06/BookSearch")] 
public interface IBookSearch 
{ 



SERVIZI SENZA CONTRATTI 



[OperationContractQ] 



string FindByName(string bookName); 



} 



Il codice riportato specifica esattamente le opera- 
zioni che il nostro servizio deve implementare per 
poter poi essere consumato dai client che ne faran- 
no sottoscrizione. L'interfaccia diventa, nella nostra 
applicazione, il contratto del servizio. Proviamo ad 
implementare l'interfaccia definita aggiungendo 
un nuovo file, chiamato BookSearch.es, ed inseren- 
do il codice seguente: 



Il modello basato sui contratti 
consente di trattare facilmente ed 
in modalità strongly-typed i 
messaggi scambiati tramite i 
servizi. Cosa succede, però, se non 
conosciamo a priori il contenuto 
del messaggio? In che modo ci 
dobbiamo comportare? Anche in 
questo caso esiste un particolare 
servizio che si occupa di leggere il 
contenuto del messaggio SOAP 
senza la necessità di definirlo a 
priori. Il servizio non utilizza 
nessun contratto, ma accetta in 
ingresso un solo parametro di tipo 



Message e restituisce in output un 
oggetto dello stesso tipo. 
Riprendendo l'esempio 
dell'articolo, potremmo avere il 
contratto del servizio così 
strutturato: 

[ServiceContract()] 

public interface IBookSearch 

i 

[OperationContract()] 
Message FindByName(Message 

request); 



} 



public 


class BookSearch : IBookSearch 


{ 


public string FindByName(string bookName) 


{ 


// qui 


l'implementazione del servizio che ritorna 


// la descrizione del libro richiesto 


// il codice completo è disponibile sul CD allegato 


} 


} 



Ho volutamente omesso, nell'articolo, l'implemen- 
tazione interna del metodo FindByName per moti- 
vi di spazio. Il codice presentato rappresenta l'im- 
plementazione di un servizio che accetta in input il 
nome del libro e ne verifica la presenza all'interno 
dello store. Da notare è come non sia necessario 
definire nuli' altro che l'interfaccia da implementare 
per realizzare un servizio. Questo significa che 
siamo in grado di implementare l'interfaccia anche 
più volte ed in maniera del tutto differente. 
Possiamo ora mettere in hosting il nostro servizio, 
ad esempio, su una Console Application. Creiamo 
quindi un nuovo progetto console, aggiungiamo un 
riferimento alla libreria dei servizi precedentemen- 



il codice riportato crea un hosting che si occupa di 
esporre l'implementazione del servizio, contenuta 
nella classe Library.BookSearch, attraverso un end- 
point composto rispettivamente da un address 
http: //localhost:9001 /BookSearch, un binding 
identificato con l'utilizzo dell'oggetto basicHttp 
Binding e un contratto definito nella nostra inter- 
faccia Library.IBookSearch. Il consumer del servizio 
apre invece un canale (channel) per attivare la 
comunicare: 

// creo il channel 

ChannelFactory< Library.IBookSearch > channel = new 

ChannelFactory< Library.IBookSearch >(" BookSearch E 

dpointConfig "); 
// creo il proxy 

Library.IBookSearch proxy = channel. CreateChannel(); 
// utilizzo il metodo per la traduzione 



string descrizione 



proxy. FindByName 

("Programming Indigo"); 



Il codice dimostra come il consumer comunica con 
il provider di servizi attraverso l'apertura di un 
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canale utilizzando la classe ChannelFactory. Nel 
caso viene utilizzata una sezione del file di configu- 
razione per definire le caratteristiche dell' endpoint 
da raggiungere. Il codice completo è disponibile sul 
ed allegato alla rivista. 



URI SERVIZIO AVANZATO 
CON IL DATACOniTRACT 

Il servizio implementato nel precedente paragrafo 
accetta tipi semplici sia come parametri sia come 
valori di ritorno. Molto spesso, però, abbiamo la 
necessità di scambiare informazioni più complesse 
e diversamente strutturate, eventualmente control- 
landone la serializzazione. Se, ad esempio, volessi- 
mo ottenere maggiori informazioni sul libro cerca- 
to, come ad esempio il prezzo ed il codice ISBN, 
abbiamo l'esigenza di utilizzare un particolare tipo 
di contratto: il DataContract. Esso consente di 
serializzare l'entità Book e contemporaneamente di 
ottenere uno schema dettagliato per descriverne al 
meglio le proprietà o le variabili locali che intendia- 
mo trasferire. Per questo scopo definiamo l'entità 
Book utilizzando gli attributi DataContract e 
DataMember: 



public string Name; 



[DataMember(Name="description")] 



public string Description; 



[DataMember(Name="price")] 



public decimai Price; 



[DataMember(Name="isbn")] 



public string ISBN; 



> 



Modifichiamo il ServiceContract aggiungendo un 
nuovo OperationContract che consente di ottenere 
un servizio avanzato: 

[ServiceContract(Namespace="http:// 

www.ioprogrammo.it/2006/06/BookSearch")] 
public interface IBookSearch 

S 

[OperationContract()] 
Booklnfo FindByName(string bookName); 
} 

di conseguenza modifichiamo l'implementazione 
del servizio. Provando ad eseguire il tutto otteniamo 
un risultato come quello visualizzato in FIGURA . 



[DataContract(Name= 


"booklnfo")] 




public 


class Booklnfo 






{ 




[DataMember(Name="name 


')] 



SVILUPPARE CON WCF. COSA CI SERVE? 



Per cominciare a sviluppare servizi 
con Windows Communication 
Foundation dobbiamo scaricare ed 
installare le seguenti componenti 
rispettando l'ordine indicato: 
2 Visual Studio 2005 - E' l'ambiente 
di sviluppo per la produzione di 
applicazioni basate sul .NET 2.0. 
Rappresenta comunque un 
componente facoltativo poiché le 
applicazioni sono compilatoli anche 
da linea di comando. E' anche 
possibile utilizzare le versioni 
express di visual studio scaricabili 
da questo indirizzo: 
http://msdn.microsoft.eom/vstudio/e 
xpress/default.aspx 

• WinFX Runtime Components - 
Consentono l'esecuzione delle 
applicazioni WinFX. Sono 
scaricabili dall'indirizzo: 
http://www. microsoft.com/ 
downloads/details.aspx?Famil 
yld=F51 C4D96-9AEA-474F- 
86D3-172BFA3B828B& 
displaylang=en 



• Windows SDK - Include 
documentazione, esempi, tool e 
ambienti per lo sviluppo sia di 
applicazioni Windows native che 
basate sul WinFX. L'SDK è 
scaricabile dall'indirizzo: http: 
//www.microsoft.com/downloads/ 
details.aspx?Familyld=9BE1 FC7F- 
0542-47F1 -88DD-61 E3EF88C402 
&displaylang=en 

• "Orcas" WinFX Development 
Tools - Fornisce funionalità 
aggiuntive all'IDE di sviluppo 
Visual Studio 2005, come 
l'intellisense per XAML e i project 
templates per Windows Workflow 
Foundation e Windows 
Communication Foundation. E' un 
componente opzionale, dipende 
se si utilizza Visual Studio come 
ambiente di sviluppo, e può 
essere scaricato da questo 
indirizzo: http://www.microsoft. 
com/downloads/details.aspx?Fami 
ly ld= AD0CE56E-D7B6-44BC-91 OD- 
E91 F3E370477&displaylang=en 



MESSAGECONTRACT 

Alcuni scenari, però, potrebbe prevedere lo scam- 
bio di messaggi che non necessariamente includo- 
no dei particolari tipi o entità, ma richiedono un 
maggior controllo diretto sul messaggio. Con il 
MessageContract possiamo intervenire diretta- 
mente sulla definizione delle proprietà per indicare 
se esse devono far parte dell'intestazione (header) o 
del corpo (body) del messaggio. Questo controllo 
avviene sempre in maniera dichiarativa utilizzando 
gli attributi MessageContract per l'indicazione del 
contratto, MessageHeader e MessageBody per la 
definizione del comportamento delle proprietà o, 
eventualmente, delel variabili locali rispettivamen- 
te al messaggio SOAP. Ipotizziamo l'uso del messa- 
ge contract per implementare un servizio che 
richiede la fornitura di informazioni supplementari 
come come, ad esempio, un identificativo univoco 
del client. 

[MessageContract()] 

public class FindByNameRequestMessage 

S 

[MessageHeader(Name="clientIcT)] 
public string ClientlD; 
[MessageBody(Name="bookName")] 
public string BookName; 



[MessageContract()] 

public class FindByNameResponseMessage 
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{ 


[MessageHeader(Name="clientId")] 


public string ClientlD; 


[MessageBody(Name="bookName")] 


public Booklnfo Book; 


} 



Il codice riportato imposta due tipi di 
MessageContract. Il primo definisce il messaggio 
soap che il consumer invia al servizio, mentre il 
secondo specifica la risposta del servizio verso il 
consumer. Ovviamente il messaggio non è limitato 
ai tipi semplici, ma può anche essere utilizzato in 
combinazione con gli altri contratti, come il 
DataContract. E' così che realizziamo una nuova 
versione del servizio che fa uso, appunto, del 
MessageContract: 

[ServiceContract(Namespace="http:// 

www.ioprogrammo.it/2006/06/BookSearch")] 
public interface IBookSearch 
{ 



[OperationContractQ] 



FindByNameResponseMessage 
FindByName(FindByNameRequestMessage request); 



> 



Provando ad intercettare il messaggio SOAP ci 
accorgiamo come questo viene trattato e serializza- 
to. In FIGURA vediamo un esempio di messaggio. 



COMTRACT VERSIONiniG 

Nella stesura dell'articolo siamo intervenuti più 
volte nel nostro contratto originale per modificarne 
le caratteristiche in base alle mutate esigenze. 
Modificando i parametri del metodo FindByName 
abbiamo violato una delle regole della Service- 
Oriented Architecture: Services are Autonomous. In 
pratica i client che prima implementavano quel 
contratto, ora non saranno più in grado di comuni- 
care con il servizio, proprio a causa delle sue muta- 
te caratteristiche. Questo ci porta a dover gestire il 
versioning, che può aver luogo su due diversi livelli: 

• A livello di ServiceContract, quando ad esempio 
vengono rimosse delle operation oppure ne ven- 
gono modificati o aggiunti parametri 

• A livello di DataContract, quando vengono 
modificate, rimosse o aggiunte proprietà 

Nel primo caso è importante tenere presente che 
non possiamo eseguire Foverload dei metodi, ma se 
proprio non ne possiamo fare a meno, dobbiamo 
specificare la proprietà name che trasformerà la 
action nel WSDL. In qualsiasi caso è fondamentale 
mantenere invariato il servizio precedentemente 



creato. Il nostro esempio sarebbe così: 

[ServiceContract(Namespace="http:// 

www.ioprogrammo.it/2006/06/BookSearch")] 
public interface IBookSearch 

i 

[OperationContract(Name = "FindByName")] 
string FindByName(string bookName); 



[OperationContract(Name 



"FindByNameV2")] 



Booklnfo FindByName(string bookName); 



> 



Il versioning nel DataContract riguarda principal- 
mente l'aggiunta di nuovi membri pubblici. Se 
infatti dobbiamo aggiungere un nuovo membro 
Price al nostro oggetto Book, dobbiamo garantire la 
compatibilità con i precedenti consumer. Ci viene 
in soccorso la proprietà IsRequired. Se settata a 
false, infatti, rende facoltativa la presenza della 
nuova proprietà, un po' come la keywork optional 
di visual basic. In questo scenario la classe Book 
sarebbe così: 

[DataContract(Name="bookInfo")] 
public class Booklnfo 

i 

[DataMember(Name="name")] 

public string Name; 

[DataMember(Name="description")] 

public string Description; 

[DataMember(Name="price")] 

public decimai Price; 

[DataMember(Name="isbn")] 

public string ISBN; 

[DataMember(Name="language" 

IsRequired = "false"))] 

public string Language; 
} 



E' importante anche il ruolo del namespace, che 
diventa il mezzo per distinguere i contratti nel 
WSDL. Nel caso in cui, infatti, abbiamo la necessità 
di rendere obbligatoria la nuova proprietà, la solu- 
zione è quella di creare una nuova interfaccia defini- 
ta all'interno di un diverso namespace. 



CONCLUSIONI 

Nell'articolo abbiamo visto come l'infrastruttura di 
Windows Communication Foundation consente di 
rispondere agevolmente alle esigenze che riguarda- 
no le attuali architetture service-oriented. 
Garantendo al contempo interoperabilità fra le 
varie piattaforme. Il futuro senza dubbio non può 
prescindere da questo tipo di applicazione. 

Fabio Cozzolino 
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IO PROGRAMMO BY EXAMPLE 

IMPARA A PROGRAMMARE IN MODO PRATICO E DIVERTENTE, CON GLI ESEMPI PASSO PASSO 
CHE TI GUIDANO ALLA COSTRUZIONE DEL CODICE 



COME POSSO 



ESSEME1 SAPERE SE UNA CONNES- 
SIONE È ATTIVA? pag. 42 

Usiamo la libreria wininet.dll per capire se la 
Lan o il Modem sono connessi ad un deter- 
minato momento 

COME POSSO 
EZEEM ACCEDERE AL REGISTRO 
DI SISTEMA? pag. 43 

È possibile farlo attraverso la classe 
Registry di Microsoft. Win32. Vediamo 
come recuperare informazioni sulla CPU 
attraverso il registry 

| COME POSSO FARE L'U- 
| PLOAD DI UN FILE TRAMI- 
TE IL WEB 

pag. 44 

PHP e ASP.NET hanno approcci profonda- 
mente diversi. Vediamo come risolvere il 
problema con i due linguaggi 

COME POSSO AGGIUNGERE UN SUONO A 
UN BOTTONE IN EXCEL? 

pag. 46 

Occorre richiamare una DLL contenuta nel 
sistema. La procedura tuttavia è abbastanza 
semplice 




COME POSSO EVIDENZIARE LA CELLA 
ATTIVA DI EXCEL? 

pag. 47 

Utiliziamo una macro e il visual basic script 
editor per gestire l'evento sheetselection- 
chance 




CHE COSA È RUBY? 

pag. 48 

Probabilmente si tratta del linguaggio in più 
forte ascesa del momento. Vi mostriamo un 
esempio su come creare un grafico in Excel 
tramite uno script sviluppato in Ruby 

COME POSSIAMO MIGRARE UN DATABA- 
SE DA ACCES A MYSQL? 

pag. 49 

Utilizziamo il MYSQL migration tool kit, uno 



strumento gratuito che ci consente di tra- 
sportare dati da qualunque DB 






* 



COME POSSO ESEGUIRE BACKUP PERIO- 
DICI DI MYSQL? 

pag. 52 

ancora una volta ci vengono in aiuto gli 
strumenti visuali messi a disposizione da 
MYSQL AB 



VUOI INVIARE UN ESEMPIO? 

Se sei un programmatore esperto ed 
hai risolto un problema, puoi 
aiutare gli altri pubblicando il tuo 
codice. Proponi i tuoi esempi 



no@edmaster.i 



Come contattarci? 

Alla nostra redazione arriva spesso un considerevole 
numero di email riguardante temi specifici. Per con- 
sentirci di rispondere velocemente e in modo adegua- 
to alle vostre domande abbiamo elaborato una FAQ - 
Frequently Ask Question - o risposte alle domande 
frequenti in italiano, di modo che possiate indirizzare 
le vostre richieste in modo mirato. 

Problemi sugli 
abbonamenti 

Se la tua domanda ha a che fare con una delle seguen- 
ti: 

• Vorrei abbonarmi alla rivista, che devo fare? 

• Sono un abbonato e non ho ricevuto la rivista, a 
chi devo rivolgermi? 

• Sono abbonato ma la posta non mi consegna 
regolarmente la rivista, a chi devo rivolgermi? 

Contatta abbonamenti@edmaster.it specificando 
che sei interessato a ioProgrammo. Lascia il tuo indi- 
rizzo email e indica il numero dal quale vorresti far 
partire l'abbonamento. Verrai contattato al più presto. 
Oppure puoi chiamare lo 02 831212 



Problemi sugli allegati 

Se riscontri un problema del tipo: 

• Ho acquistato ioProgrammo ed il Cdrom al suo 
interno non funziona. Chi me lo sostituisce? 

• Ho acquistato ioProgrammo ma non ho trovato il 
cd/dvd all'interno, come posso ottenerlo? 

• Vorrei avere alcuni arretrati di ioProgrammo co- 
me faccio? 

Contatta servizioclienti@edmaster.it 

Non dimenticare di specificare il numero di copertina 
di ioProgrammo e la versione: con libro o senza libro. 
Oppure telefona allo 02 831212 

Assistenza tecnica 

Se il tuo problema è un problema di programmazione 
del tipo: 

• Come faccio a mandare una mail da PHP? 

• Come si instanzia una variabile in c++? 

• Come faccio a creare una pagina ASP.NET 

o un qualunque altro tipo di problema relativo a 



tecniche di programmazione, esplicita la tua 
domanda sul nostro forum: http://forum.iopro- 
grammo.it, uno dei nostri esperti ti risponderà. Le 
domande più interessanti saranno anche pubblica- 
te in questa rubrica. 

Problemi sul codice 
alFinterno del CD 

Se la tua domanda è la seguente 

• Non ho trovato il codice relativo all'articolo all'in- 
terno del ed 

Consulta la nostra sezione download all'indirizzo 
http://cdrom.ioprogrammo.it, nei rari casi in cui il 
codice collegato ad un articolo non sia presente nel 
cdrom, senza dubbio verrà reso disponibile sul nostro 
sito. 



Idee e suggerimenti 



Se sei un programmatore esperto e vuoi proporti 
come articolista per ioProgrammo, oppure se hai sug- 
gerimenti su come migliorare la rivista, se vuoi inviar- 
ci un trucco suggerendolo per la rubrica tips & tricks 
invia una email a 
ioprogrammo@edmaster.it 
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COME POSSO SAPERE SE UNA 
CONNESSIONE E ATTIVA? 

USIAMO LA LIBRERIA WININET.DLL PER CAPIRE SE LA LAN O IL MODEM SONO CONNESSI IN 
UN DETERMINATO MOMENTO 



VISUAL BASIC.NET 



I FACCIAMOLO IN C# 

1 Creiamo un nuovo progetto di tipo Windows 
Application e sulla form trasciniamo un 
bottone e una label dalla palette degli strumenti 
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2 Spostiamoci nella sezione relativa al codice e 
aggiungiamo le seguenti righe poco sotto quel- 
le della dichiarazione della classe 

[DIIImport("wininet.dN")] 

private static extern bool 
InternetGetConnectedState(out int Description, int 

ReservedValue); 
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3 Aggiungiamo un nuovo metodo che sfrutti il 
riferimento esterno appena dichiarato 

public static bool IsConnectedToInternet() 

{_ 

int Description 
return InternetGetConnectedState(out 
Description, 0); 



> 



4 Portiamoci di nuovo sulla form e clicchiamo 
due volte sul bottone per generare il metodo 
che gestirà l'evento OnClick 



private void buttonl_Click(object sender, 



EventArgs e) 



label l.Text = 

IsConnectedToInternet().ToString();} 

COME FUNZIONA? 

La DLL wininet esporta il metodo InternetGet 
ConnectedState. Questo metodo prende come 
input due parametri. Un parametro che contiene 
la descrizione del tipo di connessione da testare: 
INTERNET_CONNECTION_LANJNTERNET_CON- 
NECTION_MODEMJNTERNET_CONNECTION 
_PROXY f INTERNET_ CONNECTION_OFFLINE e una 
costante riservata che possiamo considerare 
sempre uguale a 0. Ricaviamo il nome della con- 
nessione da testare attraverso la parola chiave 
Out alla quale passiamo inizialmente una descri- 
zione vuota. InternetGetConnect State restituisce 
un valore boolean se la connessione è attiva. 
Nella gestione del click non facciamo altro che 
farci stampare questo valore a video. 



CHE VUOL DIRE 
CONNESSIONE ATTIVA? 

Per connessione Attiva non si intende che il cavo sia 
connesso e che la connessione sia ben configurata, ma si 
intende proprio capire se a livello software il mezzo di 
trasporto è predisposto al funzionamento. Ovvero questa 
procedura restituisce false se la connessione alla lan viene 
disattivata dal pannello di controllo, ma continua a 
restituire true se la connessione è attiva e il cavo scollegato 



GLI IMPORT DA USARE CON 

C# 

using System; 

usingSystem.Collections.Generic; 

using System.ComponentModel; 

using System.Data; 

using System. Drawing; 

using System.Text; 

using System.Windows.Forms; 

using System.Runtime; 

using System.Runtime.InteropServices; 
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I FACCIAMOLO CON 
VISUAL BASIC 

1 Creiamo un nuovo progetto di tipo Windows 
Application e sulla form trasciniamo un botto- 
ne e una label dalla palette degli strumenti 

Private Declare Function 

InternetGetConnectedState Lib "wininet" _ 

(ByVal Description As Integer, ByVal 

ReservedValue As Integer) As Boolean 



I Riscriviamo la Function che richiama la DLL in 
i questione 



Public Function IsConnectedToInternetQ As Boolean 



Dim Description As Integer 



Return 

InternetGetConnectedState(Description, 0) 
End Function 

3 Infine riscriviamo il metodo che gestisce il click 
sul bottone. La sintassi è abbbastanza sempli- 
ce, si tratta di modificare il testo della label 

Private Sub Buttonl_Click(ByVal sender As 

System. Object, ByVal e As System. EventArgs) 
Handles Buttonl. Click 



Labell.Text 



IsConnectedToInternet.ToString() 



End Sub 



COME POSSO ACCEDERE AL REGISTRO 
DI SISTEMA? 

E' POSSIBILE FARLO ATTRAVERSO LA CLASSE REGISTRY DI MICROSOFT.WIN32. VEDIAMO 
COME RECUPERARE INFORMAZIONI SULLA CPU ATTRAVERSO IL REGISTRY 



I FACCIAMOLO IN C# 

1 Creiamo una nuova applicazione di tipo 
Windows Application e trasciniamo sulla form 
un bottone e una label 




2 Clicchiamo due volte sul bottone per generare 
il codice di gestione del'evento OnClick e scri- 
viamolo come segue: 



private void buttonl_Click(object sender, 

EventArgs e) 


{ 




label l.Text = 


get_cpu(); 




} 


3 


Scriviamo la il metodo get_cpu() 




private string get_cpu() { 




RegistryKey 


_Key; 






RegistryKey 


_LocalMachine = 





Registry.LocalMachine; 



_Key=_l_ocalMachine.OpenSubKey("); 
Object obj=_Key.GetValue("Identifier"); 



return obj.ToStringQ; 



> 



COME FUNZIONA? 

Sfruttiamo la classe RegistryKey per instanziare due 
oggetti di questo tipo. Il secondo oggetto lo inizializ- 
ziamo facencdolo puntare al registro locasle, prelevia- 
mo poi la chiave che ci interessa attraverso il metodo 
OpenSubKey, infine recuperiamo il valore della key 
attraverso il metodo GetValue. Infine valorizziamo la 
funzione. 

GLI IMPORT DA USARE CON 

C# 

All'inizio del codice è necessario aggiungere 

using System; 

using System.Collections.Generic; 

using System.ComponentModel; 

using System. Data; 

using System. Drawing; 

using System. Text; 

using System. Windows.Forms; 

using Microsoft. Win32; 



I FACCIAMOLO CON 
VISUAL BASIC 

1 Ricreiamo la form così come abbiamo fatto per 
C# e clicchiamo due volte sul bottone per gene- 



VISUAL BASIC.NET 
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rare il codice di gestione dell'evento OnClik. Il codi- 
ce sarà il seguente 

Private Sub Buttonl_Click(ByVal sender As 

System. Object, ByVal e As System. EventArgs) 
Handles Buttonl. Click 
Label l.Text = get_cpu() 
End Sub 



un bottone 



I Scriviamo il metodo get_cpu come segue 



Private Function get_cpu() As String 



Dim _Key As RegistryKey 



Dim _LocalMachine As RegistryKey 



Dim obj As Object 



_LocalMachine = Registry.LocalMachine 
_Key = 
_LocalMachine.OpenSubKey("HARDWARE\\DESCRIP 
TION\\System\\CentralProcessor\\0") 
obj = _Key.GetValue("Identifier") 



Return obj.ToString 



End Function 



= = Box gli import da usare in Visual Basic = 
AN'inzio del codice è necessario aggiungere 



Imports Microsoft. Win32 



GLI IMPORT DA USARE 
IN VISUAL BASIC 

AN'inzio del codice è necessario aggiungere 
Imports Microsoft. Win32 



COME POSSO FARE L'UPLOAD DI UN 
FILE TRAMITE IL WEB 

PHP E ASP.NET HANNO APPROCCI PROFONDAMENTE DIVERSI. VEDIAMO COME RISOLVERE IL 
PROBLEMA CON I DUE LINGUAGGI 



ASP.NET 




FACCIAMOLO 
IN ASP.NET 

Creiamo un nuovo progetto Web 



1 



File Edit View Website Build Debug fools Window Community Help 



(Jose Solution 



Save Default. aspx.vb Ctrl+5 
Save Default. aspx.vb As... 
Advanced Save Options. . . 
Save AH Ctrl+Shift+S 

'- :..' empiate... 



Page ìetup... 
Print... 



Recent Files 
Recent Projects 



.jp Project... 



j. Website.., 



IM File '" Ctrl+N Lvb* Default.aspx 

Project From Existing Code. . , 



(D, 



gPartial Class _Default 

Inherit System. Web . UI . Page 



Protected Sub Buttonl_Click (By\i 
If FileUploacll.HasFile Thei 
Try 

FileUploadl.SaveAs 
Labell.Text = "Upl< 
Catch ex As Exception 

Labell.Text = "Si i 
End Try 
Else 

Labell.Text >= "Non è st 
End If 
End Sub 



2 Nella maschera che segue poniamo attenzione 
nel selezionare "Asp.NET Web Site" e in basso il 
nome del linguaggio "Visual Basic" 
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3 Realizziamo una pagina web trascinando su di 
essa un componente di tipo FileUpload, un 
bottone e una label 
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4 Clicchiamo due volte sul bottone per creare lo 
scheletro del codice di gestione dell'evento 
OnClick e modifichiamolo come segue 

Protected Sub Buttonl_Click(ByVal sender As 

Object, ByVal e As System. EventArgs) Handles 

Buttonl. Click 

If FileUploadl.HasFileThen 

Try 

FileUpload l.SaveAs("C:\uploads" & 



FileUpload l.FileName) 



Labell.Text = "Upload avvenuto con successo!!" 



Catch ex As Exception 



Labell.Text = "Si è verificato un errore!" 



End Try 
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Else 


Label l.Text = 


"Non è stato selzionato nessun file." 


End If 


End Sub 



COME FUNZIONA? 

Il componente FileUpload è un'innovazione del 
Framework 2.0, il suo utilizzo facilita di molto la gestio- 
ne dell'upload di file sul web. Il funzionamento suffi- 
cientemente semplice. Nel primo if utilizziamo il meto- 
do HasFile per sapere se l'utente ha effettivamente 
selezionato un file da uploadare, se non lo ha fatto 
modifichiamo in modo opportuno il testo della label. 
Se l'utente ha selezionato qualche file proviamo ad 
effettuare l'upload attraverso il metodo SaveAs, se 
tutto funziona regolarmente modifichiamo opportuna- 
mente il testo della label, viceversa intercettiamo l'ec- 
cezione e scriviamo un messaggio d'errore 

^SFACCIAMOLO IN C# 

1 Ripercorriamo i passi da uno a quattro avendo 
cura di modificare il nome del linguaggio nella 
seconda dialog box. Clicchiamo due volte sul bot- 
tone e modifichiamo il codice come segue 



protected void Buttonl_Click(object sender 



,EventArgs e) 



if (FileUploadl. HasFile) { 



try{ 



FileUploadl. SaveAs("C:\\uploads\\" + 

FileUpload l.FileName); 
Label l.Text = "Upload avvenuto con successo!!"; 

} catch (Exception ex) { 
Label l.Text = "Si è verificato un errore!"; 
} 



} else { 



Labell.Text = "Non è stato selzionato nessun file."; 

} 

} 

^SFACCIAMOLO IN PHP 

1 Creiamo un file chiamato index.php e al suo 
interno inseriamo il seguente script 

<html> 
<head> 
<script type="text/javascript"> 



function hasfileQ { 



if 
(document.getElementByld('userfile').value !="") { 



contenitore. submit(); 



} else { 



document.getElementById('feedback').innerHTML= 

devi selezionare almeno un file"; 



} 



</script> 



</head> 



<body> 



<p id=feedbackx/p> 



<form id=contenitore enctype="multipart/ 

form-data" action="" method=post> 
<input name="userfile" id="userfile" type="file"> 
<input value="Invia" type=button onclick="hasfile()"> 
</form> 
<? 
$uploaddir = 7home/fabio/public_html/upl2/'; 



$uploadfile = $uploaddir . 



basename($_FILES['userfile']['name']); 



echo "<pre>"; 



(move_uploaded_file($_FILES['userfile']['tmp_name' 

L $uploadfile)) { 

echo '<script type="text/javascript">'; 
echo ' 

document.getElementById(Vfeedback\').innerHTML= 
"File Uploadato con successo"'; 



echo '</script>'; 



} else { 



echo ' 

document.getElementById(Vfeedback\').innerHTML= 
"Si è verificato un errore contattarelVamministratore"'; 



} 



?> 

COME FUNZIONA IN PHP? 

Abbiamo dovuto ricreare comportamenti che in .NET 
sono implementati direttamente nel framework, con 
un miscuglio di PHP e JavaScript. In realtà la parte 
JavaScript serve soltanto a validare la form. Prima di 
effettuare il submit si controlla che ci sia almeno qual- 
cosa di scritto nel campo file, dopodiché si effettua l'u- 
pload con i metodi previsti da PHP. Se tutto va a buon 
fine viene cambiato il campo di feedback ancora tra- 
mite Javascript 



COME POSSO CHIUDERE TUTTI I FOGLI DI EXCEL? 



U 



n metodo abbastanza semplice è 
il seguente: 



Public Sub CloseAIIQ 



Dim Wb As Workbook 



SaveAII 



For Each Wb In Workbooks 



If Wb.Name <> ThisWorkbook.Name Then 
Wb.Close savechanges:=True 



End If 



Next Wb 



ThisWorkbook.Close savechanges: =True 



End Sub 



http://www.ioprogrammo.it 



Luglio 2006/ 045 ► 



ESEMPI ► .EXCEL 



COME POSSO AGGIUNGERE UN SUONO 
A UN BOTTONE IN EXCEL? 



OCCORRE RICHIAMARE UNA DLL CONTENUTA NEL SISTEMA. LA PROCEDURA TUTTAVIA E 
ABBASTANZA SEMPLICE 



I Abilitiamo la palette dei moduli cliccando su 
I visualizza/barre degli strumenti/moduli 
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| Dalla barra dei moduli selezioniamo un 
■ bottone 
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3 Disegniamo il bottone sul foglio di lavoro 
utilizzando il mouse. Appena finito comparirà 
anche una dialog box 
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I Dalla Dialog Box delle macro selezioniamo 
P nuovo 



Baldi 






JD Scegli 










Nuovo da r 
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G|] Model 
C Model 
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Annulla 
Nuovo 


























Registra... 
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■Modifichiamo il codice di gestione 



Declare Function sndPlaySound32 Lib "winmm.dll" 



Alias . 



"sndPlaySoundA" (ByVal IpszSoundName AsString, 



ByVal uFIags As Long) As Long 



Sub Pulsantel_Clic() 



CallsndPlaySound32("c:\programmi\media\ 
chimes.wav", 0) 



End Sub 



COME POSSO RECUPERARE IL NOME 
DEI FOGLI ATTIVI? 



Per recuperare il nome del primo 
foglio presente nella cartella: 

Public Function FirstSheetNameO 

FirstSheetName = Sheets(1).Name 
End Function 

Per ottenere un array contenente tutti i 



nomi dei fogli presenti 



Dim Arr() As String 



Dim I as Integer 



Redim Arr(Sheets.Count-l) 



For I = To Sheets.Count - 1 



Arr(i) = Sheets(l+1).Name 



Nextl 



AHSheetNames = Arr 



Public Function AlISheetNamesQ 



1 return a row array OR 



AHSheetNames = 
Application.Worksheetfunction.Transpose(Arr) 



1 return a column array 



End Function 
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COME POSSO EVIDENZIARE LA CELLA 
ATTIVA DI EXCEL? 

UTILIZZIAMO UNA MACRO E IL VISUAL BASIC SCRIPT EDITOR PER GESTIRE L'EVENTO 
SHEETSELECTIONCHANGE 



1 Apriamo un nuovo foglio di lavoro e dal menu 
strumenti selezioniamo Macro /Visual Basic 
Editor 



m -l« 


strumenti Dati FlashPaper Finestra ? Adobe PDF 










-4- 


Controllo ortografia... F7 
Controllo errori... 






- io T ; G 


C £ 1 m m m 






Condividi cartella di lavoro. , . 






) 


Conversione euro... 
Collaborazione in linea ► 


H 


1 


J 


K 


L 


























Verifica formule ► 
























































| Macro 


y Macro... ALT+F8 
Registra nuova macro. . . 
Protezione... 








Personalizza.., 
Opzioni... 
















al Basic Editor ALT+F11 






















m Microsoft Script Editor ALT+MAIUSC+F11 































































2 Dallo script editor clicchiamo due volte su 
"This Workbook", comparirà uno spazio per 
l'immissione del codice 



wm 



— i 



CNSTJ ' 2! ■_,.< 



w 



3 Selezioniamo dal menu a tendina di destra 
"WorkBook" e dal menu a tendina di sinistra 
"Sheet Selection Change" comparirà lo scheletro 
di gestione del codice. Il codice da aggiungere è il 
seguente 

Private Sub Workbook_SheetSelectionChange(ByVal 

Sh As Object, ByVal Target As Range) 

Static OldRange As Range 
On Error Resumé Next 

Target. Interior.Colorlndex = 6 ' yellow - 

change as needed 



Old Range. Interior.Colorlndex 



xlColorlndexNone 



Set OldRange = Target 



End Sub 

4 Torniamo al foglio di lavoro cliccando sul 
simbolo in alto a sinistra 



1m Microsoft Visual Basic - Cartel! - [This Workbook (codice)] 



<^j. File Modifica Visualizza 

Visualizza Microsoft Ex;: si 
OD bài |i — T| 



^ Eurotool (EUROTOOL.XLA 
|Sf VBAProject (Cartel 1) 

- -Si Microsoft Excel Oggetti 
B] Foglici (Foglici) 
S] Foglio? (Foglio^) 
S] Foglio3 (Foglio3) 
••■© This Workbook 




COME POSSO CALCOLARE L'ETÀ 
DI UNA PERSONA? 



I 



I metodo più semplice è usare la 
funzione datediff come segue 



= ") & " anni, " & DATEDIF(A1 f NOW(),"ym") & " 
mesi, " & DATEDIF(A1 f NOW(),"md") & " giorni" 

che ritorna una stringa del tipo 
33 anni, nove mesi, 18 giorni 
Ma possiamo usare la stessa funzione 
anche in codice VBA come segue: 



Function Age(Date1 As Date, Date2 As Date) As 

String 
Dim Y As Integer 
Dirti M As Integer 



Dim D As Integer 



Dim Tempi As Date 



Tempi = DateSerial(Year(Date2), 

Month(Datel), Day ( Date 1) 

Y = Year(Date2) - Year(Datel) + (Tempi > Date2) 



Date2)) 

D = Day(Date2) - Day(Datel) 



If D < Then 



M = M-1 



D = Day(DateSerial(Year(date2), 
Month(date2),0)) + D 



Endlf 



Age = Y & " years " & M & " months " & D & 
" days" 



M = Month(Date2) - Month(Datel) - (12 * (Tempi > End Function 
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CHE COSA E RUBY? 



PROBABILMENTE SI TRATTA DEL LINGUAGGIO IN PIÙ FORTE ASCESA DEL MOMENTO. VI 
MOSTRIAMO UN ESEMPIO SU COME CREARE UN GRAFICO IN EXCEL TRAMITE UNO SCRIPT 
SVILUPPATO IN RUBY 



1 



Dal menu start avviamo l'editor FreeRide 



CJ "ime 1 1 

C3 trtJComnoiKfcr * \ 


<m W.ubf » £j H jfc.viLiv-]-.. » 


CJ) Btfcyjcre *l 

Éf 1 rtjrh-i- — ■■_-'.• .-- -■•' ■ ■•{ J-y!/™rldrB 
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^ IrfilLLdKot 
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2 Non ci sono regole complesse da seguire per la 
scrittura di uno script in ruby. E' sufficiente 
scrivere il codice, per farlo avremmo potuto anche 
usare il notepad. Il nostro codice d'esempio è il 
seguente: 

require 'win32ole' 

ChartTypeVal = -4100; 

excel = WIN320LE.new("excel. application") 
excel[Visible'] = TRUE; 



workbook = excel. Workbooks.Add(); 
excel. Range("al")['Value'] = 3; 



excel. Range("a2")['Value'] = 2; 



excel. Range("a3")['Value'] = 1; 



excel. Range("al:a3").Select(); 



excelchart = workbook. Charts.Add(); 
excelchart['Type'] = ChartTypeVal; 



30.step(180, 10) do |rot| 



excelchart['Rotation'] = rot 



end 



excelchart2 = workbook. Charts.Add(); 
excelchart3 = workbook. Charts.AddQ; 



3 Salviamo lo script in una qualunque posizione 
sul disco ed eseguiamolo cliccando due volte 
sul file. Il risulatato sarà sorprendente. In figura 
vedete un'immagine statica, nella realtà il vostro 
grafico effettuerà una rotazione 3D 




COME FUNZIONA? 

Uno degli elementi di forza di ruby sta nella curva di 
apprendimento decisamente bassa. In questo script 
viene instanziato un oggetto Excel tramite una API 
Win32. Questo oggetto rappresenta in tutto e per tutto 
un foglio excel. A questo foglio viene per prima cosa 
aggiunta una cartella di lavoro, a seguire si riempiono 
tre celle con un valore e infine si aggiunge un grafico, 
valorizzato sulla base di una selezione effettuata sulle 
celle appena riempite. L'effetto rotazione si ottiene con 
un semplice ciclo di for. 



DOVE POSSO TROVARE 
RUBY? 

Nel CD allegato alla nostra rivista, oppure OnLine 

all'indirizzo 

http://wvtfw.rubycentral.com/downloads/index.html 



charts = workbook. Charts 
charts.each { |i| puts i } 



excel. ActiveWorkbook.Close(O); 



excel. QuitQ; 



CHE COSA E RUBYONRAILS 

Sostanzialmente un framework i sviluppo per Ruby. Quello 
che è più interessante è che ha appena vinto il premio 
come miglior FrameWork dell'anno! 



COME POSSO OTTENERE UN NOME DA UN IP? 



I 



n php è abbastanza semplice, è suffi- stbyaddr 
ciente utilizzare la funzione getho- <?php 



$hostname=gethostbyaddr("151.99.125.2"); 
print Shostname; ?> 
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COME POSSIAMO MIGRARE UN 
DATABASE DA ACCESS A mvchi ? 




UTILIZZIAMO IL MYSQL MIGRATION TOOLKIT, UNO STRUMENTO GRATUITO CHE CI CONSEN- 
TE DI TRASPORTARE DATI DA QUALUNQUE DB 



I Prima di tutto lanciamo il MySQL Migration 
I Toolkit 







5 

1 
1 

( 




jT/^U rf Wriuai*» [hr^Kecn 4rMhn lottli 
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li 




CZED 
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| Selezioniamo Direct Migration se il database 
■Access è presente sulla nostra stessa macchina 



3* 

9 






t\ 



gi^^r^^rrr: 



®l ■ 



> Dal menu a tendina che compare selezioniamo 
) MS Access 



database you want to migrate frorn. 



ionnection 



5ystern: M5 Access 



Driver: 



irarmeters 



^> 



inection: 



Generic Jdbc 
M5 5QL Server 
MySQL Server 
Oracle Database Server 



Source Connection Parameter 

Please enter the connection pararmeters to 
connect to the database. 



+ - 



I Riempiamo la form sottostante indicando il 
P percorso del file da cui effettuare la migrazione 



Connection Pararmeters 



-, 



j^> 



Source Connection Parameter 

Please enter the connection pararneters to 
connect to the database. 



Stored Connection: 



J^ 







IjlI 



Database File : | G : \personal\ioProg_DVD_4_rnodiFicatc 
Usernarme: 
Password: 



MS Access database file. 

Nanne of the user to connect with. 

The user's password. 



5 eseguiamo la stessa operazione indicando 
questa volta le credenziali per il database 
MySQL target 



Target Database Connection 



Database System: 


| MySQL Server 


v l 


Select a 
Choose i 










[MySQL JDBC Driver 3.1 










^8J 


Target Connection Parameter 

Please enter the connection pararneters to 
connect to the database, 


Nanne or 
Nanne of 
The user 


i G i 


Stored Connection: 


1 


Port: |3306 | 


Hostnarne: 


localhost 








Usernarne: 


mot 


1 








Password: 


**+****| 


1 



6 Clicchiamo su Next, verrà effettuato un test per 
verificare che tutte le condizioni per la 
migrazione siano soddisfatte 



Connecting to Servers 

Establishing database connections. 



Connection Progress 

Tasks to execute 

The following tasks will now be executed. Please monitor the execution 
progress. Press [Advanced >>] to see the log. 



® Connecting to source database system 

y5 Retrieve schema information from source database system 

(jj Test connection to target database system 

Execution completed successfully. 
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7 Clicchiamo ancora su Next e selezioniamo il 
nome per il database che dovrà contenere il DB 
Access importato 




Bouree Schemata Selection 

Choose the schemata you want to migrate. 



Schemata 
Select ali schei ,,-,i 3 that h.; ? to be migrateci. 



E 



8 ; 



Se tutto è andato a buon fine tutti i check 
'daranno esito positivo 



Reverse Engineering 

Reverse engineering the source database. 



;e Engineering Progress 

Tasks to execute 

The followìng tasks wìll now be executed. Please monitor the execution 
progress. Press [Advanced »] to see the log. 

(j3 Reverse Engineering 

® Check Result 

(jjj Get Available Migration Methods 

Execution compieteci successfully. 



(Nella maschera seguente possiamo decidere 
quale tabelle migrare 




A 



i3 rr*" 



10 



Infine cliccando ancora Next fino alla fine il 
DB verrà completamente migrato 



Cdt T.xfc W*>dow lieto 
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COME POSSO ESEGUIRE BACKUP 
PERIODICI DI MYSQL ? 

ANCORA UNA VOLTA CI VENGONO IN AIUTO GLI STRUMENTI VISUALI MESSI A DISPOSIZIONE 
DA MYSQL AB 



1 



Iniziamo lanciando MySQL Administrator e 
inserendo le credenziali di autenticazione 



M^^^UK 



Mysqc 

Administrator 



Details >> 



0K 



o 



Connect to MySQL Server Instance 






Stored Connection: 




V 


l-l 












Server Host: 


localhost 


Port: 


3306 














Username: 


root 












Password: 


— i 















Clear 



Cancel 



| Selezioniamo Backup dal menu a sinistra e 
■ New Project dal bottone in basso 



File Edit View Tools Window Help 



f Server Information 
Service Control 
Startup Variables 
i*1itì| UserÀdministration 
jgj^ Server Connections 
■^ Health 
l:IM Server Logs 
jp Replication Status 



Restore 
'K^gf Catalogs 



A 



Backup Project Advanced Options Schedule 



1 Dehne the nam-f and congni ■'■! 'he backup 



Project Nanne: 



; -_;chenfia 
Q ioprog_dvd_4_modificato 
§) nnysql 
Fj 'est 
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) Diamo un nome al progetto e stabiliamo di 
) quali DB vogliamo mantenere un Backip 




4 Dalla Tabsheet Advanced selezioniamo 
eventuali opzioni particolari per la tipologia di 
Backup. Lasciare le impostazioni di default è una 
buona soluzione 



BBB99E 
fi: 






I -^ IL-™ 1 



■Dal menuTools selezioniamo Options 



J| MySQL Administrator - root@Localhost:3306 



File Edit View | I Window Help 



Server Infor 
Service Cor 
Startup Var 
UserÀdmin 
Server Con 
Health 
Server Logs 



MySQL Query Browser 
MySQL Command Line Client 
MySQL System Tray Monitor 



ect A 



edule 



Windows Command Line 



;ify if th 



Manage Connections ... 
Save current Connection . 



Replication Status 



-rager 

Filename 



Eidule tr 
: older: 



6 Dalla Tabsheet "General Options" scegliamo 
"Store Password" e indichiamo il metodo 
"Obscured" come sistema per salvare le password 
per l'accesso al database di cui mantenere il 
Backup. Questa operazione ci consente anche di 
aumentare la sicurezza con cui manteniamo i dati 
all'interno del nostro computer 




o 



ns Options 
Store Windows Positions 

l~l Disable transparency effects 




Language: System Default 

Note: a lev other than 
englis! QL site. 



Genera! Optiom 



r> 



Password Storage 
Store passwords 



Password sforane rnethod: 



ion Fonts 



Plaìntexl 

mm 



- 



Obscured 
OS Specific 



Derauit Font: MS San; Seri!' 



Dato Font: MS Sans Serif 



v Size 8,3 



Code Font: Bitstream Vera Sans Mi vj Width: 1 7 -y] Size 1 8,3 v| pt ^Choose^J 









Ignorelist: 


Connection Dialog NoDefaul chi ma Specified 


[ Remove ] 













■Infine indichiamo quali sono i giorni e le ore in 
cui desideriamo che il Backup venga effettuato 



tese 



li 






^ 




8 Indichiamo l'utente di sistema e diamo il via al 
backup. Verrà generato un file sql composto dal 
nome del file più la data in cui il backup è stato 
effettuato. Infine possiamo anche eseguire il primo 
Backup cliccando su Execute 



a 



r^rn 
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STORED PROCEDURE 
IN CODICE MANAGED 

UNA DELLE NOVITÀ PORTATE DALL'ACCOPPIATA .NET 2.0 E SQL SERVER 2005 È COSTITUITA 
DALLA POSSIBILITÀ DI SCRIVERE METODI DIRETTAMENTE DAL PROPRIO LINGUAGGIO 
PREFERITO PER POI UTILIZZARLI DALL'INTERNO DEL DB. VEDIAMO COME FUNZIONA... 





REQUISITI 



■ imi 'i ii'ii'i ^m 

~ SQL Server, T-SQL, C# o 



■j JWindows 2000, SQL 
' Server 2005, .Net 
Framework 2.0 



EJL^dL^JL^J 



Tempo di realizzazione 







Quante volte ci è capitato di dover scrivere 
delle query con calcoli matematici mol- 
to complessi e di non riuscire ad espri- 
merle come volevamo? 

In questi casi, in genere, dovevamo estrarre i 
dati da SQL Server, "lavorarli" con il linguag- 
gio di programmazione che stavamo utilizzan- 
do per la nostra applicazione e magari rinviar- 
li a SQL Server. Questo determinava un aumento 
della complessità dell'applicazione ed uno spre- 
co di risorse di rete per la comunicazione tra 
database ed applicazione. 
T-SQL è un ottimo linguaggio per le comuni 
operazioni sui database ma non ha certamen- 
te la potenza espressiva di un linguaggio di pro- 
grammazione come per esempio C#. 
Una delle principali novità di SQL Server 2005 
è l'integrazione con il CLR del framework 2.0: è, 
infatti, possibile scrivere stored procedure, trig- 
ger e funzioni in managed code. 
Attualmente i linguaggi del framework sup- 
portati sono VB. Net, C# e managed C++. 



I VANTAGGI 

E LA TECNOLOGIA 

Cosa significa esattamente scrivere stored pro- 
cedure in CLR? L'opportunità fornita da Visual 
Studio 2005 è la seguente: 

• Creo una DLL utlizzando il linguaggio che 
mi è più familiare 

• La DLL conterrà dei metodi che restituisco- 
no dei valori sulla base di certe elaborazioni 

• Posso elaborare i dati utilizzando i tipi e le 
strutture che più preferisco adottati dal mio 
linguaggio di riferimento 

• L'elaborazione dei dati può essere semplice, 
ad esempio una differenza fra date temporali, 
o anche complessa, coinvolgendo a sua vol- 
ta dati provenienti da un DB. 

• Una volta che la mia DLL è pronta la registro 



in SQL Server, e posso richiamarla da qua- 
lunque progetto sotto forma di Stored Pro- 
cedure. Una bella comodità non trovate? 



UN ESEMPIO CONCRETO 

Supponiamo di voler ricavare il numero della 
settimana corrente. Se utilizzassi direttamente 
T-SQL potrei adottare una formula del genere: 



SELECT DATEPART(ww,'2006-24-05') 

il valore risultante sarebbe 22, tuttavia il valo- 
re reale è 21. T-SQL non è preciso in questo! Se 
ripetiamo la stessa operazione in codice ma- 
naged otteniamo 

Private Sub Buttonl_Click(ByVal sender As 

System. Object, ByVal e As System. EventArgs) 
Handles Buttonl. Click 
Dim dDate As Date 
dDate = #5/24/2006 12:14:00 PM# 
Label l.Text = DatePart("ww", dDate, Firs 

DayOfWeek.Monday, FirstWeekOfYear. 
FirstFourDays).ToString 
End Sub 

Il cui risultato è 21, come ci aspettavamo. Poter 
sviluppare le Stored Procedure in codice ma- 
naged significa poter ricompilare questo me- 
todo come DLL, registrarla in SQL Server e uti- 
lizzare la Stored Procedure corretta ogni qual 
volta essa ci possa servire. 



SVILUPPARE IN CLR 

Ciascun oggetto managed da noi creato ha un 
attributo che indica a SQL Server 2005 che ti- 
po di componente CLR stiamo realizzando. 
Questi attributi possono essere ad esempio Sql- 
Storedrocedure o SqlFunction. 
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Una semplice stored procedure potrebbe esse- 
re 

public partial class StoredProcedures 

S 

[Microsoft. SqlServer.Server.SqlProcedure] 
public static void NstaUtentiQ 



{ 



SqlConnection myconn = new SqlConnection(); 
myconn.ConnectionString = 

"Context Connection=true"; 



myconn. Open(); 



using (myconn) 



{ 



SqlCommand mycomm 



string sql = "select * from utenti"; 



mycomm. Connection = myconn; 



mycomm. CommandText = sql; 



SqlDataReader myreader = nuli; 



using (myreader = 



mycomm. ExecuteReader()) 



SqlPipe p; 



p = SqlContext.Pipe; 



p.Send( myreader ); 



}; 



Compilando il codice otteniamo un assembly 

che va installato su SQL Server. 

La sintassi per l'installazione è la seguente 

CREATE ASSEMBLY <nome_assembly> 
FROM <percorso_dll> 

Nel nostro caso scriveremmo 

CREATE ASSEMBLY StoredProcedures 

FROM c:\progetti\sqlserver\ CLRIntegration.dll 

Quando integriamo un assembly in SQL Server, 
abbiamo la possibilità di specificare il livello di 
permessi per l'esecuzione tramite la sintassi 
WITH PERMISSION_SET = livello. 
Il livello di sicurezza può assumere tre valori: 
SAFE, EXTERNAL e UNSAFE. 
Una volta integrato Fassembly, possiamo uti- 
lizzare la dll per mappare le funzioni create in og- 
getti di SQL Server. 

Per creare una stored procedure utilizziamo la 
sintassi 

CREATE PROCEDURE <nome_procedura> 

AS EXTERNAL NAME <identificatore_assembly>. 

<nome_tipo>.< metodo 



nel nostro esempio 



CREATE PROCEDURE listaUtenti 



AS EXTERNAL NAME CLRIntegration. 

StoredProcedures. listaUtenti 

Allo stesso modo possiamo creare funzioni 

CREATE FUNCTION <nome_funzione> 

(<lista_parametri>) 



RETURNS <tipo_di_ritorno> 



AS EXTERNAL NAME <identificatore_assembly>. 

<nome_tipo>.< metodo 



new SqlCommandQ; e trigger 



CREATE TRIGGER <nome_trigger> 



ON <tabella_o_view> <FOR|INSTEAD OF|AFTER> 

<INSERT|UPDATE|DELETE> 

AS EXTERNAL NAME <identificatore_assembly>. 

<nome_tipo>.< metodo 



VISUAL STUDIO 2005 

Il modo più naturale di scrivere oggetti mana- 
ged per SQL Server 2005 è utilizzare Visual Stu- 
dio 2005 che offre all'utente diverse funziona- 
lità per semplificarne lo sviluppo e, soprattutto, 
il deploy. 

Visual Studio 2005 ha, infatti, un nuovo tipo di 
progetto "SQL Server Project" che può essere 
utilizzato per scrivere oggetti managed per SQL 
Server 2005 dei quali riesce a creare automati- 
camente i template. Tramite Visual Studio 2005 
è, inoltre, possibile fare il debug degli oggetti 
per testarne il corretto funzionamento. 
Vediamo come utilizzarlo per creare stored pro- 
cedure, funzioni e trigger in CLR. 
Per gli esempi utilizzeremo la tabella Utenti ot- 
tenuta dalla seguente query DDL 

CREATE TABLE [dbo].[Utenti]( 

[idUtente] [int] IDENTITY(1,1) NOT NULL, 

[nome] [varchar](50) COLLATE Latinl_ 

General_CI_AS NOT NULL, 

[cognome] [varchar](50) COLLATE 

Latin l_General_CI_AS NOT NULL, 

[email] [varchar](50) COLLATE 

Latin l_General_CI_AS NOT NULL, 

[scadenza] [varchar](50) COLLATE 
Latin l_General_CI_AS NOT NULL CONSTRAINT 
[DF_Utenti_scadenza] DEFAULT 

(dateadd(year,(l),getdate())), 

CONSTRAINT [PKJJtenti] PRIMARY KEY CLUSTERED 

( [idUtente] ASC ) 

) 




CLR 

Acronimo di Common 
Language Runtime, è il 
motore runtime del 
framework .Net 
E' composto da due 
parti principali: il 
motore di esecuzione 
vero e proprio che 
permette di caricare in 
memoria gli assembly 
ed eseguirli, e da una 
libreria di classi che 
contengono una serie 
di classi per le 
funzionalità più 
disparate. 
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SQLCONTEXT 

SqlContext 

rappresenta il contesto 

di esecuzione del 

managed code. 

Fornisce l'accesso agli 

oggetti SqlPipe 

SqlTriggerContext e 

Windowsldentity. 

Ha inoltre una 

proprietà IsAvailable 

che ci dice se la 

connessione è 

disponibile. 



Creiamo un nuovo progetto di tipo SQL Server 
Occorre creare una reference al database: sele- 
zioniamo il mone del server ed il database 
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F/£. 1: Creazione di un progetto "Sql Server" 




Fig. 2: Aggiunta di un riferimento a Sql Server 



STORED PROCEDURE 

Supponiamo di voler creare una semplice pro- 
cedura che seleziona gli utenti in base all'ini- 
ziale del cognome. 

Per creare delle stored procedure, clicchiamo 
con il tasto destro del mouse sul nome del pro- 
getto, selezioniamo "Add" e poi "Stored proce- 
dure..." 
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Chiamiamo la procedura "FiltraUtenti" e scriviamo 
il codice per estrarre i dati. 
Nella creazione di una Stored Procedure occorre 
ricordare tre cose fondamentali: 

- la classe che la contiene deve essere public 

- il metodo esposto deve essere public e static 

- Il metodo esposto va "decorato" con l'attribu- 
to SqlProcedure 

Vediamo il codice in C# 

using System; 

using System. Data; 

using System. Data. SqlClient; 



using System. Data. SqlTypes; 



using Microsoft. SqlServer. Server; 



public partial class Stored Procedures 



{ 



[Microsoft. SqlServer.Server.SqlProcedure] 
public static void FiltraUtenti(SqlString iniziale) 



{ 



using (SqlConnection connection = new SqlC 

nection("context connection=true")) 



connection. OpenQ; 



string sql 



"select * from utenti " + 



" where " + 



" substring(cognome,l,l) = '" + iniziale. 

ToString() + ; 

SqlCommand command = new 

SqlCommand(sql, connection); 



SqlDataReader r = command. 



ExecuteReaderQ; 



SqlContext. Pipe. Send(r); 



e il corrispondente in Visual Basic.NET 



Imports System 



Imports System. Data 



Imports System. Data. SqlClient 



Imports System. Data. SqlTypes 



Imports Microsoft. SqlServer.Server 



Partial Public Class StoredProcedures 

< Microsoft. SqlServer.Server.SqlProcedure()> . 



Public Shared Sub FiltraUtenti (iniziale as 



SqlString) 



Using connection As New SqlConnection("context 

connection=true") 



connection. OpenQ 



Dim sql As String = "select * from utenti " &._ 



" where " &_ 



" substring(cognome,l,l) 



'" &. 



iniziale. ToString & 



Fig. 3: Creazione di una Stored Procedure 



Dim command As New SqlCommand 
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(sql, connection) 



Dim reader As SqlDataReader 



reader = command.ExecuteReader() 



SqlContext.Pipe.Send(reader) 



End Using 



End Sub 



End Class 



ANALIZZIAMO IL CODICE 

La prima cosa che notiamo è che la procedura 
è "Decorata" con un attributo "Microsoft.Sql- 
Server.Server.SqlProcedure". Tale attributo di- 
ce a SQL Server che la funzione FiltraUtenti è una 
Stored Procedure. 

La procedura ha un parametro di tipo SqlString; 
il framework 2.0 fornisce, infatti, un insieme di 
tipi, inclusi nel namespace System. Data.SqlTy- 
pes, corrispondenti a quelli di SQL Server. Non 
è obbligatorio usarli ma è buona norma farlo. 
Utilizziamo, quindi, un oggetto connection che 
inizializziamo passando al costruttore la strin- 
ga "context connection=true". Stiamo utiliz- 
zando un managed provider per F accesso ai da- 
ti chiamato SqlServer Data Provider ed imple- 
mentato nella namespace System.Data.SqlSer- 
ver. L'oggetto principale del namespace è Sql- 
Context che rappresenta il contesto di esecu- 
zione del managed code. 

Abbiamo poi l'oggetto SqlPipe che è utilizzato 
per inviare i risultati dal server al client. Que- 
sto oggetto ha un metodo Send che ha quattro 
overload per consentire di inviare String, Sq- 
lError, SqlDataReader oppure SqlResultSet. 
Con SqlContext.Pipe.Send (reader), utilizziamo 
il metodo Send per inviare un SqlDataReader 
ottenuto dall'esecuzione della query. 
Una volta scritto il codice occorre fare i deploy 
della stored procedure: clicchiamo con il tasto 
destro del mouse sul nome del progetto e sele- 
zioniamo "Deploy". 
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Abbiamo creato la nostra stored procedure che 
sarà visibile da SQL Server 2005. A questo pun- 
to, possiamo eseguirla da SQL Server. 
Apriamo SQL Server Management Studio e col- 
leghiamoci al nostro database 
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Fig. 5: SQL Server Management Studio 

Creiamo una nuova query ed eseguiamo infine 
la Stored Procedure. 

DECLARE ©iniziale nvarchar(4000) 
set ©iniziale = 'a' 

EXECUTE [Morpheusweb].[dbo].[FiltraUtenti] 

©iniziale 

Se proviamo ad eseguire la query, invece della li- 
sta di utenti che ci aspettiamo, potremmo ot- 
tenere il seguente errore: 

Execution of user code in the .NET Framework is 

disabled. Enable "clrenabled" configuration option. 

Questo perché l'esecuzione di codice CLR è di- 
sabilitata di default su SQL Server. Per abilitar- 
la, ci basta utilizzare una stored procedure di 
sistema sp_configure. 



— Abilitaiamo l'esecuzione di cod 


ce 


CLR 


EXEC sp_configure 


'clr enabled' , 


T 




go 


reconfigure; 



Fig. 4: Deploy di un oggetto 



A questo punto, potremo eseguire con succes- 
so la stored procedure. 

Tramite Visual Studio 2005 è anche possibile ese- 
guire il debug delle stored procedure e di tutti gli al- 
tri oggetti creabili in CLR. Per farlo, occorre inseri- 
re un breakpoint nel punto in cui vogliamo inizia- 
re il debug e scrivere la query in cui utilizziamo 
l'oggetto in un apposito file, chiamato Test.sql, che 
Visual Studio crea automaticamente. 



LE FUNZIONI 

Tra gli oggetti di SQL Server che utilizziamo 
spesso ci sono anche le funzioni. Anche queste 
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SQLTRIGGERCO 
MTEXT 

Fornisce informazioni 

sul trigger che viene 

scatenato. 

Ha una proprietà 

chiamata TriggerAction 

che ci dice quale 

azione ha scatenato il 

trigger (Insert, Update, 

Delete...) 



possono essere scritte in CLR come le Stored 
Procedure. 

Le funzioni sono molto simili a delle stored pro- 
cedure, ma a differenza di queste devono resti- 
tuire un valore. 

Proviamo a realizzarne una che controlla, tramite 
una regular expression, se un indirizzo email è 
valido. Utilizzeremo poi la funzione come con- 
straint per la tabella. 

Creiamo una nuova funzione, vediamo il codi- 
ce in C# 

using System; 

using System. Data; 

using System. Data. SqlClient; 



using System. Data. SqlTypes; 



using Microsoft. SqlServer.Server; 



using System. Text.RegularExpressions; 
public partial class UserDefinedFunctions 



{ 



[SqlFunction( 



DataAccess= DataAccessKind . None, 



SystemDataAccess=SystemDataAccessKind 



None, 



IsDeterministic=true, 



IsPrecise=true)] 



public static SqlBoolean IsEmail(SqlString email) 



{ 



string mail_regex = @ M/v ([a-zA-Z0-9_\. 

V])+\@(([a-zA-Z0-9\-]{2,»+\.) + ([a-zA-Z0- 

9]{2,»+$"; 

Regex expr = new Regex(mail_regex); 



return expr.IsMatch(email.Value); 



Notiamo subito l'utilizzo dell'attributo Sql- 
Function (che indica una funzione di SQL Ser- 
ver) con alcune proprietà. DataAccess e Sy- 
stemDataAccess impostate a None indicano che 
non viene utilizzato il Data Provider InProc di SQL 
Server mentre IsDeterministic è utilizzata per indicare 
che la funzione restituisce sempre lo stesso risul- 
tato a fronte di uno stesso valore in input. 
Otteniamo il valore di ritorno della funzione tra- 
mite l'istruzione return. Una volta fatto il deploy, pos- 
siamo utilizzare la function come constraint sul 
campo email della nostra tabella utenti. 

CREATE TABLE [dbo].[Utenti]( 

[idUtente] [int] IDENTITY(1,1) NOT NULL, 

[nome] [varchar](50) COLLATE Latinl_ 
General_CI_AS NOT NULL, 

[cognome] [va renar] (50) COLLATE 
Latin l_General_CI_AS NOT NULL, 

[email] [varchar](50) COLLATE Latinl_ 
General_CI_AS NOT NULL, 

[scadenza] [varchar](50) COLLATE 

Latinl_General_CI_AS NOT NULL 

CONSTRAINT [DF_Utenti_scadenza] 

DEFAULT (dateadd(year,(l),getdate())), 

CONSTRAINT [PKJJtenti] PRIMARY KEY 
CLUSTERED 

( [idUtente] ASC) WITH (IGNORE_DUP_KEY 
= OFF) ON [PRIMARY] 

) ON [PRIMARY] 

ALTER TABLE [dbo]. [Utenti] 

WITH CHECK ADD CONSTRAINT [CK_Utenti_email] 
CHECK (([dbo].[isEmail]([email]) = (l))) 



e il corrispondente in Visual Basic 



Imports System 



Imports System. Data 



Imports System. Data. SqlClient 



Imports System. Data. SqlTypes 



Imports Microsoft. SqlServer.Server 



Imports System.Text.RegularExpressions 

Partial Public Class UserDefinedFunctions 

<SqlFunction(DataAccess: = DataAccessKind. Read, 
SystemDataAccess:=SystemDataAccessKind.Read, 
IsDeterministic: =True, IsPrecise:=True)> _ 
Public Shared Function IsEmail(ByVal email As 

SqlString) As SqlBoolean 
Dim mail_regex As String = M/v ([a-zA-Z0-9_\.\- 
])+\@(([a-zA-Z0-9\-]{2,»+\.) + ([a-zA-Z0- 

9]{2,»+$" 

Dim expr As Regex = New Regex(mail_regex) 



Return expr.IsMatch(email.Value) 



End Function 



End Class 



Se proviamo ad eseguire una semplice query di 
inserimento 

INSERT INTO [Morpheusweb].[dbo].[Utenti] 

([nome] , [cognome], [email]) 

VALUES ('Carmelo', 'Scuderi'/mailerata') 

Otteniamo un errore di SQL Server 

"The INSERT statement conflicted with the CHECK 
constraint "CK_Utenti_email". The confliet occurred in 
database "Morpheusweb", table "dbo. Utenti", column 

'email'." 

Utilizzando una mail corretta invece l'inseri- 
mento va a buon fine. 



UTILIZZIAMO TRIGGERS 

In modo simile a come visto per le stored pro- 
cedure e le funzioni, è possibile creare dei ma- 
naged trigger. Quando si crea un trigger occor- 
re decorare la funzione con l'attributo SqlTrig- 
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ger che ha due parametri: 

- Target: la tabella del nostro database su cui crea- 
re il trigger 

- Event: l'evento che scatena il trigger (ad esem- 
pio: "FOR UPDATE", "FOR INSERT") 

Per inviare mail tramite SQL Server in CLR, la 
proprietà "Permission Level" dell'assemMy de- 
ve essere impostata a "Unsafe". 
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Fig. 8: Deploy di assembly Unsafe 

Quando facciamo il deploy potremmo ottene- 
re un errore dovuto al fatto che SQL Server, per 
default, non consente il deploy di assemby che 
non siano Safe. 

Per abilitare questa possibilità, occorre configura- 
re il parametro "TRUSTWORTHY ON" sul data- 
base in cui dobbiamo creare il trigger. Per farlo ese- 
guiamo la query: 

ALTER DATABASE Morpheusweb SET TRUSTWORTHY 

ON; 

Fatto questo, esaminiamo il codice del trigger, in 

C# 



Connection("context connection=true")) 



connection. OpenQ; 



string sql ■■ 



"select nome, cognome, email, scadenza 
from inserted"; 
SqlCommand command = new 

SqlCommand(sql, connection); 



SqlDataReader myReader; 



using (myReader = 



command. 

ExecuteReaderQ) 



if (myReader.ReadQ) 



{ 



string nomeCompleto ■■ 



myReader["nome"] + " " + 

myReader["cognome"]; 



string email 



myReader["email"]. 

ToString(); 



string scadenza = Convert.ToDate 

Time(myReader["scadenza"]) 
.ToString("dd/MM/yyy"); 



MailMessage myMail 



new 
MailMessage(); 



myMail. From = new MailAddress("web 
master@morpheusweb.it"); 
myMail.To.Add(new 

MailAddress(email)); 
myMail. Body = 

"Ciao " + nomeCompleto + ", grazie 
per esserti iscritto\r\n" + 
"La tua utenza scadrà il " + 
scadenza; 



myMail. IsBodyHtml = false; 



SmtpCIient emailClient = new 
SmtpClient("IL_TUO_SERVER_SMTP"); 



emailClient. Send(myMail); 




using System; 



using System. Data; 



using System. Data. SqlClient; 



using Microsoft. SqlServer. Server; 



using System. Data. Sql; 



using System. Net. Mail; 



public partial class Triggers 



{ 



[Microsoft.SqlServer.Server.SqlTrigger( 



Name="SendMail", 



Target="Utenti", 



Event="AFTER INSERT")] 



public static void SendMailQ 



{ 



SqlTriggerContext myContext = SqlContext. 

TriggerContext; 
if (myContext. TriggerAction == TriggerAction. 

Insert) 



{ 



using (SqlConnection connection = new Sq 



e il corrispondente in Visual Basic.NET 



Imports System 



Imports System. Data 



Imports System. Data. SqlClient 



Imports System. Data. SqlTypes 



Imports Microsoft.SqlServer.Server 



Imports System. Net. Mail 

Partial Public Class Triggers 

< Microsoft. SqlServer.Server.SqlTrigger(Name: = "Send 
Mail", Target: = "Utenti", Event: ="AFTER INSERT")> _ 



Public Shared Sub SendMailQ 



Dim myContext As SqlTriggerContext = 

SqlContext.TriggerContext 
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If (myContext.TriggerAction = 




Carmelo Scuderi è 

ingegnere informatico. 

Si occupa di sviluppo 

software web-based 

per una società di 

telecomunicazioni di 

Milano. 

Gestisce un sito web 

ricco di script e manuali 

per chi si affaccia al 

mondo della 

programmazione web 

(www. morpheusweb. it) 




SUL WEB 



SQL Server 2005 

http://www.microsoft.com/ 

ita ly/sq l/Def au It. mspx 

SQL Server 2005 

Express 

http://msdn.microsoft.com 

/vstudio/express/sql/ 

SQL Server Central 

http://www.sq Iservercentr 

al.com/ 

SqIJunkies 

http://www.sqljunkies. 

com/ 



TriggerAction. 

Insert) Then 



Using connection As New SqlConnection 

("context connection=true") 



connection. OpenQ 



Dim sql As String = "select nome, cognome, 
email, scadenza from inserted" 
Dim command As SqlCommand = New S 

Command(sql, connection) 
Using myReader As SqlDataReader = 

command. ExecuteReader() 
If (myReader.ReadO) Then 

Dim nomeCompleto As String = 

myReader("nome").ToString() &_ 
" " + myReader("cognome"). 

ToString() 
Dim email As String = 

myReader("email").ToString() 
Dim scadenza As String = Convert. 
ToDateTime(myReader("scadenza")).ToString 

("dd/MM/yyy") 

Dim myMail As MailMessage = New 

MailMessage() 
myMail. From = New MailAddress 

("webmaster@morpheusweb.it") 



myMail.To.Add(New 



MailAddress(email)) 



myMail. Body = 



"Ciao " & nome 

Completo &_ 



", grazie per esserti iscritto\r\n" &_ 



"La tua utenza scadrà il " & scadenza 



myMail. IsBodyHtml = False 



Dim emailClient As SmtpCIient = New 
SmtpClient("IL_TUO_SERVER_SMTP") 



emailClient. Send(myMail) 



End If 



End Using 



End Using 



End If 



End Sub 



End Class 

SQL Server 2005 supporta l'oggetto SqlTrigger- 
Context che viene utilizzato per ottenere infor- 
mazioni sul trigger. 

Tramite questo oggetto vediamo quale azione è 
stata intrapresa sulla tabella Utenti e, se si tratta di 



SQLPIPE 



L'oggetto SqlPipe consente di 
eseguire procedure direttamente 
sul database e poi inviare i risultati 
dal server al client. I due metodi 
principali dell'oggetto sono Send 
ed ExecuteAndSend. 
ExecuteAndSend accetta come 
parametro un SqlCommand e come 



azione esegue la query passata 
come CommandText ed invia i 
risultati al client. 
Send invia direttamente dei 
risultati al client. Ha quattro 
overload per consentire di inviare 
String, SqlError, SqlDataReader 
oppure SqIResultSet. 



un inserimento (TriggerAction.Insert), eseguiamo 
il codice che invia la mail. 

Per farlo, eseguiamo una query "select nome, co- 
gnome, email, scadenza from inserted" che recu- 
pera l'ultimo inserimento e creiamo una mail da 
inviare all'utente utilizzando l'oggetto MailMes- 
sagge del namespace System.Net.Mail. 
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Fig. 6: Debug di un oggetto 



T-SQL VS CLR 

La possibilità di scrivere oggetti lato server uti- 
lizzando il framework .Net ci offre, un nuovo 
modo per sviluppare stored procedure, trigger 
o funzioni. Il rovescio della medaglia è che il 
programmatore deve decidere quando svilup- 
pare in CLR e quando, invece, continuare ad 
utilizzare T-SQL. 

In effetti, non c'è una risposta sempre valida 
ma delle linee guida. T-SQL va in genere utiliz- 
zato quando il nostro codice esegue prevalen- 
temente accesso ai dati; il motore di esecuzio- 
ne di SQL Server è molto complesso ed utilizza 
algoritmi avanzati per l'estrapolazione dei da- 
ti. CLR dovrebbe essere utilizzato quando le no- 
stre procedure hanno una logica di program- 
mazione molto complessa (ad esempio proce- 
dure ricorsive) o non possono essere espresse 
in T-SQL: con CLR otterremo prestazioni mi- 
gliori e semplicità di implementazione. 



CONCLUSIONI 

Con l'integrazione del CLR 2.0 in SQL Server 
2005 lo sviluppatore può implementare fun- 
zionalità molto complesse con estrema sem- 
plicità grazie alla possibilità di sfruttare i concetti 
di programmazione ad oggetti come l'eredita- 
rietà e l'incapsulamento. È, inoltre, possibile 
sfruttare le numerose librerie messe a disposi- 
zione dal framework per compiti che non era 
possibile eseguire con le precedenti versioni di 
SQL Server. 

Carmelo Scuderi 
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OTTIMIZZAZIONE 



DI MYSQL 



IL MODO IN CUI UNA QUERY VIENE SCRITTA PUÒ INFLUENZARE DECISAMENTE I TEMPI DI 
RISPOSTA DEL SERVER. MA QUALI SONO I PARAMETRI SU CUI BASARCI PER SCRIVERE QUERY 
EFFICIENTI? ECCO COME OTTENERE INFORMAZIONI UTILI PER OTTIMIZZARE LE INTERROGAZIONI 





■w.i.i.wj.fcimifaua 

Principi di SQL 



Una qualunque 
versione di Linux o 
Windows. MySQL. 



'■)■■) 



i 



Tempo di realizzazione 



In questo articolo tenteremo di rispondere ad 
una domanda piuttosto frequente: "Perché il mio 
sito Web è lento?". Premesso che le risposte pos- 
sono essere praticamente infinite, analizzeremo 
tutte quelle situazioni in cui la lentezza nella visua- 
lizzazione di una pagina Web dipende da una man- 
cata ottimizzazione del database che contiene le 
informazioni utili a far girare la web application. 
Cosa succede ad esempio se dobbiamo recuperare 
da un database di 500.000 clienti le informazioni 
relative a un range di tutti i clienti che hanno effet- 
tuato un acquisto nel mese corrente? 
Cinquecentomila è un numero abbastanza elevato 
da farci supporre che eseguire questa interrogazione 
sul database sia un'operazione abbastanza onerosa 
in termini di tempo. Il nostro scopo, in questo arti- 
colo, sarà appunto illustrare qualche tecnica per 
ottimizzare le prestazioni del Database. Nonostante 
questa premessa, dobbiamo dire, che la gamma 
delle possibili ottimizzazioni è talmente ampia che 
non possiamo dare una risposta certa ad ogni tipo di 
problema. La maggior parte degli utenti dovranno 
adattare le tecniche qui illustrate alla propria appli- 
cazione e spesso mescolarle fra loro fino a trovare la 
soluzione migliore. E' praticamente impossibile for- 
nire una procedura standard che conduca alla "per- 
fetta ottimizzazione" bisogna procedere per tentati- 
vi e "legare strettamente" il proprio problema alle 
tecniche illustrate. 



OTTIMIZZAZIONI 
LATO SOFTWARE 

Nonostante il fatto che nessuna ottimizzazione è 
possibile se non eseguita in maniera congiunta dal 
sistemista e dallo sviluppatore, ci concentreremo su 
quello che maggiormente ci riguarda, ovvero come 
sviluppare codice che aumenti la velocità d'esecu- 
zione delle query. Tralesceremo volutamente tutte le 
operazioni effettuabili sulla configurazione del ser- 
ver, quali ad esempio l'ottimizzazione della cache 
etc, ritenendo che questo genere di configurazione 
spetti più al sistemista che a noi. 



LA SCELTA DEL FORMATO 



Alcuni di voi sapranno che MySQL offre diversi 
"engine" per la manipolazione delle tabelle sul ser- 
ver. Ora, nonostante la definizione rigorosa possa 
essere molto più ampia, per capire cosa stiamo cer- 
cando di fare è bene riportare il piano della discus- 
sione a un livello più basso. Una tabella contenente 
dei dati, si ridurrà per noi ad un file scritto in una 
particolare zona del disco. Il file conserverà i dati 
secondo un proprio schema, e ovviamente MySQL 
dovrà disporre di un meccanismo che gli consenta 
di prelevare i dati dal file in questione secondo la 
logica con cui sono stati conservati. Per cui quando 
parleremo di formati di tabelle, intenderemo il for- 
mato con cui le tabelle vengono scritte su disco, e 
quando parleremo di engine intenderemo il motore 
interno di mysql in grado di leggere e scrivere i dati 
nel file in questione con il formato dato. Per il nostro 
articolo analizzeremo quattro engine MylSAM, 
Heap, BDB, InnoDB. Ciascuno di questi ha partico- 
larità proprie. Prima di procedere però alla descri- 
zione delle caratteristiche dei vari engine sarà bene 
dare corpo a qualche definizione che altrimenti 
potrebbe sembrare oscura. 



IL PROBLEMA DEL LOCK 

Supponiamo che i nostri dati siano contenuti in un 
unico file. Ad un certo momento l'utente A sta cer- 
cando di scrivere un dato, contemporaneamente 
l'utente B sta facendo la stessa cosa. Il risultato è che 
se tutti e due scrivono contemporaneamente il file 
potrebbe risultare danneggiato o inconsistente. Per 
cui normalmente il processo che si esegue è quello 
di assegnare in modo univoco la risorsa a chi la 
detiene. Ad esempio l'intero file viene assegnato 
all'utente A e viene messo in stato di "lock", ovvero 
nessuno può scrivere sul file fino a che l'utente A 
non ha terminato le sue operazioni. Quando l'uten- 
te A termina, il file viene sbloccato, assegnato alla 
risorsa B, e messo nuovamente in stato di lock e così 
via. Apparentemente è una soluzione semplice, tut- 
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tavia se le operazioni di scrittura sono frequenti ine- 
vitabilmente ci sarà una coda di attesa lunghissima, 
pertanto un dato verrà realmente scritto nel file con 
tempi di ritardo notevoli rispetto a quando l'utente 
l'ha inserito, con tutti i problemi che ne possono 
derivare. 

Apparentemente il problema l'utente A legge l'uten- 
te B scrive è molto più semplice. Se l'utente A sta leg- 
gendo un dato e l'utente B ne sta scrivendo un altro, 
niente di male può accadere. Ma se per pura sfortu- 
na l'utente B sta eliminado il dato letto da A si pos- 
sono riverificare problemi di consistenza. Qui entra- 
no in gioco i così detti shared locks e exclusive locks. 
Ovvero se l'utente A tenta di leggere un file viene 
applicato un lock di tipo shared, ovvero molti client 
possono continuare ad accedere in lettura, se invece 
un utente tenta di scrivere ottiene un exclusive lock 
ovvero sarà lui il proprietario della risorsa e nessun 
altro potrà leggere o scrivere fino a quando non la 
rilascia. Uno dei compiti principali degli engine di 
MySQL è dunque la gestione dei lock. L' engine in 
modo del tutto trasparente all'utente deve conti- 
nuamente stabilire su cosa effettuare un lock e con 
che modalità. I vari tipi di lock offerti dai vari engine 
rappresentano una delle basi più importanti per 
capire quale formato di tabelle adottare nella nostra 
applicazione. 



LOCK SU TABELLE 

Nelle prime versione di MySQL l' engine di default 
era MylSAM. In questo formato l'unico metodo di 
lock utilizzato è il lock sull'intera tabella. Questo 
significa che quando un utente tenta di scrivere, l'in- 
tera tabella viene bloccata e nessun altro riuscirà ad 
utilizzarla in lettura o scrittura. Questo apparente- 
mente è un grave limite. Tuttavia MySQL nel corso 
degli anni si è dimostrato velocissimo pure utiliz- 
zando questo tipo di lock nel suo engine di default. 
Il motivo di questo è da ricercarsi nel fatto che le 
applicazioni servite da MySQL sono prevalentemen- 
te Web Application e pertanto il più delle volte si 
verificano centinaia se non migliaia di operazioni di 
lettura contemporanee, mentre le operazioni di 
scrittura risultano piuttosto ridotte. Per tale motivo 
aumentare la complessità dell' engine aggiungendo 
una gestione dei lock più granulare avrebbe dimi- 
nuito la velocità dell'algoritmo senza portare van- 
taggi notevoli all'applicazione 



LOCK SU PAGINE 

Se la vostra applicazione utilizza un grado di con- 
correnza moderato nella scrittura/lettura delle 
tabelle, una buona soluzione è utilizzare l' engine 
Berkeley DB. Questo tipo di Engine blocca in scrittu- 



ra/lettura una porzione della tabella, ovvero quella 
interessata dall'operazione di scrittura. Questa por- 
zione della tabella prende il nome di "pagina" e per 
Berkeley DB ogni "pagina" ha una dimensione di 
8Kb. 



LOCK SU RIGHE 

InnoDB offre il maggior grado di concorrenza. Con 
questo engine il lock avviene sulla singola riga inte- 
ressata dall'operazione di scrittura. Oltre a questo 
tipo di protezione InnoDB utilizza un meccanismo 
noto come MVCC ovvero Multi Version Concurrency 
Control. In sostanza l' engine mantiene per ogni riga 
due informazioni addizionali nascoste al program- 
matore ovvero l'ID_CREAZIONE, l'ID_CANCELLA- 
ZIONE. Rispettivamente questi due campi conten- 
gono rispettivamente il momento in cui la riga e 
stata creata e il momento in cui la riga è stata can- 
cellata. Oltre a questo, ad ogni transazione eseguita, 
il database aumenta di un'unità un numero di ver- 
sione del database. A questo punto entra in gioco un 
meccanismo di confronto che fa si che solo le righe 
che soddisfino i criteri di consistenza del database 
vengano restituite all'utente. Tutto questo meccani- 
smo ovviamente fa si che InnoDB debba mantenere 
costantemente aggiornate le informazioni di versio- 
ning delle righe e questo aumenta esponenzialmen- 
te la complessità delle operazioni. Per tanto InnoDB 
è da usarsi soltanto se davvero avete bisogno di una 
gestione delle concorrenza delle operazioni vera- 
mente alta e sicura. 



GLI IRIDICI 

Uno dei concetti più importanti in tema di ottimiz- 
zazione di database è quello degli indici. Supponete 
di avere una tabella contenente 500.000 prodotti. Da 
questa tabella volete ricavare l'unico prodotto corri- 
spondente al nome "Mastice AttaccaTutto in un bat- 
tibaleno". Tecnicamente l' engine dovrebbe scorrere 
l'intera tabella dal primo elemento fino all'ultimo, 
confrontare il contenuto del campo "nome_prodot- 
to" con quello dato ed eventualmente restituire un 
risultato se la condizione fosse verificata. Se non 
avessimo a disposizione un computer ma un catalo- 
go cartaceo tutto sarebbe estremamente più sempli- 
ce. Molto probabilmente il catalogo sarebbe ordina- 
to in ordine alfabetico per nome_prodotto, sarebbe 
sufficiente dunque portarsi alla lettera "M" e pesca- 
re il prodotto desiderato seguendo l'ordine alfabeti- 
co. L'uso degli indici all'interno di un database 
risponde esattamente alle stesse esigenze. 
Sostanzialmente un indice è una tabella di valori 
ordinati che puntano a dati. Va da se che l'indicizza- 
zione di una tabella occupa spazio, e allo stesso 




COSA SONO LE 
TRANSAZIONI? 

Per transazione si 
intende un gruppo 
di istruzioni SQL che 
viene gestito in 
maniera atomica, 
cioè come se fosse 
un'unica operazione. 
Usare le transazioni 
garantisce un lock 
esclusivo su tutte le 
operazioni che coin- 
volgono la transazio- 
ne. In MySQL gli 
engine che supporta- 
no le transazioni 
sono Berkeley DB e 
InnoDB. MylSAM non 
gestisce le transazio- 
ni! Ovviamente il 
prezzo se si usano le 
transazioni è una 
maggiore comples- 
sità della gestione e 
di conseguenza in 
molti casi si può 
verificare una dimi- 
nuizione della velo- 
cità. Ovviamente 
tutto dipende da 
cosa dovete ottene- 
re. Se la vostra appli- 
cazione non deve 
gestire molte opera- 
zioni di scrittura con- 
temporanee e non 
ha bisogno di un 
controllo fine sul 
lock, l'erigine miglio- 
ra da utilizzare rima- 
ne MylSAM. 
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modo appare evidente che mantenere costante- 
mente ordinato un indice implica molte operazioni 
di update sull'indice stesso. Ovvero ogni volta che la 
tabella viene modificata, l'indice corrispondente 
deve essere riordinato sulla base delle modifiche 
effettuate. Perciò nell'utilizzare gli indici bisogna 
tener conto dell'occupazione dello spazio e del cari- 
co a cui si sottopone la CPU per la gestione dell'in- 
dice stesso. Creare un indice in MySQL si riduce in 



QUALE ENGINE SCEGLIERE 



Come già detto tutto dipende 
da cosa volete realizzare. Se la 
vostra tabella non coinvolge 
molte operazione di scrittura 
contemporanee e non ha biso- 
gno di gestire le transazioni, la 
scelta migliore rimane 
JVIylSAM. Ricordatevi anche che 



la scelta dell'erigine non coin- 
volge l'intero database ma 
solo le singole tabelle. 
Pertanto potete sempre deci- 
dere di utilizzare un formato 
per una certa tabella e un altro 
per una tabella che deve assol- 
vere a funzioni diverse. 



buona parte alla seguente istruzione: 



ALTER TABLE Prodotti ADD Index(nome_prodotto(3), 

prezzo_prodotto(3)); 

Attenzione che la creazione di un indice multicolon- 
na non corrisponde alla creazione di due indici 
separati. MySQL è in grado di utilizzare un solo indi- 
ce per volta! La creazione di un indice multicolonna 
consente di elaborare un solo elenco che utilizza 
due criteri di ordinamento. E' sempre possibile crea- 
re due indici: 



ALTER TABLE Prodotti ADD Index(nome_prodotto); 
ALTER TABLE Prodotti ADD Index(prezzo_prodotto); 

Ma in tal caso quando si esegue la query MySQL sce- 
glierebbe l'indice più conveniente per esaudire rapi- 
damente la richiesta. Consideriamo la seguente 
query: 



Select * from Prodotti where nome_prodotto='Mastice' 

AND prezzo ='10'; 




TABELLE HEAP 

Le tabelle HEAP sono 

particolari strutture 

dati che non vengono 

scritte su Disco ma che 

mantengono le 

informazioni 

direttamente in 

memoria. Inutile dire 

che questo genere di 

tabelle sono 

velocissime. Di contro 

le tabelle Heap non 

gestiscono 

completamente gli 

indici in modo ottimale 

e ovviamente 

consumano quantità di 

memoria gigantesche 



ALTER Table NomeTabella ADD Index(nomecampo); 

Ad esempio l'istruzione 

ALTER TABLE Prodotti ADD Index(nome_prodotto); 

Crea un indice della tabella Prodotti ordinato secon- 
do il campo nome_prodotto. Poiché abbiamo detto 
che va trovato sempre il massimo bilanciamento fra 
la dimensione dell'indice e le risorse a disposizione 
è anche possibile creare degli indici parziali, ad 
esempio l'istruzione 

ALTER TABLE Prodotti ADD Index(nome_prodotto(3)); 

Indicizza i prodotti tenendo conto solo delle prime 3 
lettere del nome del prodotto, così che la query 

Select * from prodotti WHERE 

nome_prodotto="Mastice"; 

restituisce Mastice ma anche Massaggiatore, pro- 
prio perché la query viene effettuata tenendo conto 
dei primi tre valori del nome_prodotto. Allo stesso 
modo è possibile creare indici multicolonna con la 
seguente sintassi 

ALTER TABLE Prodotti ADD Index(nome_prodotto, 

prezzo_prodotto); 

In questo modo si produce un indice che ordina i 
dati prima secondo il nome del prodotto e poi 
secondo il prezzo. Come visto in precedenza lo stes- 
so indice può essere creato in modo parziale 



Con la creazione di un unico indice multicolonna 
MySQL selezionerebbe prima un insieme di prodot- 
ti che soddisfano alla prima condizione, ma paralle- 
lamente sarebbe in grado di utilizzare un albero di 
ricerca per soddisfare la seconda condizione, per cui 
la velocità aumenterebbe notevolmente. Nel secon- 
do caso invece potrebbe utilizzare un solo indice per 
volta e la velocità diminuirebbe. 



LA PAROLA CHIAVE 
"EXPLAIN" 

Avendo fornito alcuni concetti base sulle tabelle e 
sugli indici, possiamo passare ad analizzare le 
nostre query, nella speranza di capire come ottimiz- 
zarle. Prima di tutto, per ottenere informazioni su 
come è composta una nostra tabella possiamo uti- 
lizzare la parola chiave Describe, ad esempio: 

mysql> Describe msvcs_comuni; 

Come si vede è una tabella che contiene tutti i 
comuni d'Italia. Non abbiamo definito ancora alcun 
indice ne effettuato particolari ottimizzazioni. 
Proviamo a fare un test su una nostra query utiliz- 
zando la parola chiave explain: 

mysql> explain select Comune,ComuneSigla,ComuneCAP 
from msvcs_comuni where Comune='Roma' \G 

id: 1 

select_type: SIMPLE 
table: msvcs_comuni 
type: ALL 
possible_keys: NULL 
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^Field 


rype 


Nuli 


Key 


Default 


Extra 


\ 


comunelD 


nt(11) 




PRI 


NULL 


auto increment 




Comune ' 


/archar(30) 




MUL 








comuneSigla ' 


/archar(4) 


YES 




NULL 






comunePrefTel i 


/archar(5) 




MUL 








comuneCAP i 


/archar(5) 




MUL 








REF_MAP 


/archar(100) 


jnap i 


L/archar(255) 














key: NULL 



keyjen: NULL 



ref: NULL 



rows: 8208 



Extra: Using where 



1 row in set (0.00 sec) 



id => contiene un identificatore numerico di ogni 
tabella coinvolta nell'interrogazione 
select_type => identifica un "ruolo" per la tabella 
interrogata all'interno dell'interrogazione. 
Chiariremo in un secondo momento cosa vuol dire 
esattamente "ruolo" 

table => contiene il nome della tabella interrogata 
type => contiene il tipo di join utilizzato. Chiariremo 
anche questo punto in un secondo momento 
possible_keys=> contiene un elenco di possili key 
che il server può utilizzare. Questo parametro sarà 
piuttosto importante per l'ottimizzazione degli indi- 
ci. Se la tabella non è dotata di nessun indice, in que- 
sto campo troveremo il valore "Nuli" 
key => contiene il valore dell'indice che mysql ha 
deciso di utilizzare 

keyjen => contiene il valore in byte della dimensio- 
ne della chiave 

ref => contiene le colonne che sono state utilizzate 
per confronto con la chiave 

rows => contiene il numero di chiavi che MySQL 
deve esaminare per soddisfare l'interrogazione 
Extra => contiene informazioni aggiuntive che pos- 
sono esserci utili in un secondo momento 



e rieseguiamo la query con l'explain 

mysql> explain select Comune,ComuneSigla,ComuneCAP 
from msvcs_comuni where Comune='Roma' \G 

id: 1 

select_type: SIMPLE 
table: msvcs_comuni 



Cerchiamo di capire cosa vuol dire questa risposta. type: ref 



possible_keys: Comune 



key: Comune 



keyjen: 30 



ref: const 



rows: 1 



Extra: Using where 



1 row in set (0.00 sec) 

Questa volta in rows notiamo il valore 1. Avendo 
aggiunto un indice corretto le righe interessate si 
riducono da 8208 ad appena 1! All'interno della stes- 
sa risposta notiamo che Type è passato da Ali a Ref. 
Allo stesso modo possible_keys contiene l'elenco 
delle possibili chiavi utilizzabili, in questo caso solo 
"Comune" e infine che il server ha deciso di utilizza- 
re proprio la chiave "Comune". Ora, concentriamoci 
sul "Type", la nostra explain indica che il tipo di Join 
è un "Ref". Esattamente cosa vuol dire? 
In pratica "Comune" non dispone di un "indice a 
chiave unica" ovvero potrebbero esistere più comu- 
ni con lo stesso nome. Per questo motivo MySQL è 
costretto ad usare una query incrociata fra i valori 
ritornati dall'indice e la tabella stessa. Proviamo a 
trasformare "Comune" in una chiave unica. Ovvero 
non ci possono essere valori ripetuti per il campo 
"Comune" all'interno della tabella 



URIA PRIMA 
OTTIMIZZAZIONE 

Concentriamoci prima di tutto sul valore contenuto 
in rows. Per la nostra prima query la risposta era la 
bellezza di 8208. Non esistendo un indice, MySQL 
dovrà scansionare tutte le 8208 righe della tabella e 
confrontarle con la costante che gli abbiamo fornito 
come parametro. Proviamo ad aggiungere un indice 
per vedere come varia il comportamento di MySQL: 

mysql> alter table msvcs_comuni add index(Comune); 
Query OK, 8208 rows affected (0.46 sec) 
Records: 8208 Duplicates: Warnings: 



ALTER TABLE * msvcs_comunf 



ADD UNIQUE fComunO 

e rieseguiamo l'explain 

mysql> explain select Comune,ComuneSigla,ComuneCAP 
from msvcs_comuni where Comune='Roma' \G 

id: 1 

select_type: SIMPLE 

table: msvcs_comuni 

type: const 

possible_keys: Comune_2,Comune 

key: Comune_2 

keyjen: 30 
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ref: const 


rows: 1 


Extra : 


1 


row in set (0.00 sec) 



key: NULL 



Questa volta il type è diventato di tipo "Const" ovve- 
ro la tabella viene aperta una volta sola, siamo certi 
che c'è un solo valore che soddisfa la richiesta. Le 
ricerche di tipo Const sono velocissime! 
Notiamo però che è stato creato automaticamente 
un indice Comune_2 che questa volta è di tipo "a 
chiave univoca" e che MySQL ha scelto di utilizzare 
questo tipo di indice piuttosto che il precedente. 



keyjen: NULL 



ref: NULL 



rows: 8200 



Extra: Using where 



1 row in set (0.01 sec) 

Notate che non viene utilizzato nessun indice, e che 
le righe interrogate tornano ad essere 8200. Cosa è 
successo? L'operatore Like non fa uso degli indici, 
ovvero utilizza un particolare algoritmo interno per 
cui l'indicizzazione non risulta efficiente. In caso di 
tabelle di grandi dimensioni è utile creare un indice 
'full text' e modificare la query utilizzando l'operato- 
re 'match'. Vediamo come: 



RICHIESTE DI INTERVALLI 

Proviamo adesso un'interrogazione che coinvolge 
un certo numero di dati: 



mysql> explain select Comune,ComuneSigla,ComuneCAP 
from msvcs_comuni where Comune between 'Ragusa' 

and 'Roma' \G 

id: 1 

select_type: SIMPLE 

table: msvcs_comuni 

type: range 

possible_keys: Comune_2,Comune 

key: Comune 

keyjen: 30 

ref: NULL 

rows: 282 

Extra: Using where 

1 row in set (0.01 sec) 

Notiamo che adesso il type è diventato "Range" e 
che il valore restituito in rows è 282. Cioè MySQL 
pensa che ci possano essere 282 record fra Ragusa e 
Roma, tuttavia se eseguiamo realmente la query ci 
accorgeremo che vengono restituiti appena 273 
record. Questo perché MySQL effettua una stima di 
quante righe possano essere coinvolte nel confron- 
to. In questo caso utilizzando l'indice "Comune" 
vengono confrontate 282 righe delle quali 273 soddi- 
sfano la condizione. 



ALTER TABLE % msvcs_comunf ADD 

FULLTEXT( , Comune , ) 

In questo modo creiamo l'indice full text. Proviamo 
ora a riscrivere la query utilizzando l'operatore 
match: 

mysql> explain select Comune,ComuneSigla,ComuneCAP 
from msvcs_comuni where match(comune) against 

('Ro*' IN BOOLEAN MODE) \G 

id: 1 

select_type: SIMPLE 

table: msvcs_comuni 
type: fulltext 

possible_keys: Comune_3 
key: Comune_3 
keyjen: 

ref: 

rows: 1 

Extra: Using where 

1 row in set (0.01 sec) 



Notate che adesso il type è diventato di "fulltext" e 
che viene utilizzato l'indice Comune_3 ovvero quel- 
lo creato appositamente per ricerche di questo tipo. 
Anche in questo caso c'è da annotare che gli indici 
full text occupano spazio e come tali è necessario 
utilizzarlo quando strettamente necessario 



RICERCHE SU STRINGHE 

Ora proviamo la seguente query: 

mysql> explain select Comune,ComuneSigla,ComuneCAP 
from msvcs_comuni where Comune like 'Ro%' \G 

id: 1 

select_type: SIMPLE 
table: msvcs_comuni 
type: ALL 
possible_keys: NULL 



CONCLUSIONI 

Abbiamo appena sfiorato la punta dell'iceberg delle 
tecniche di ottimizzazione in MySQL. In particolar 
modo l'uso sapiente dell'istruzione Explain e degli 
indici consente di ottenere miglioramenti significa- 
tivi nel recupero dei dati. Noterete che non abbiamo 
approfondito alcune tematiche relative agli indici o 
alle chiavi, il nostro intento era fornire le basi per ini- 
ziare a capire come lavora MySQL. In futuro non 
mancheremo di continuare ad occuparci dell'argo- 
mento andando sempre più in profondità 
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FRAMMENTI 
DI SAGGEZZA 



CAPITA SPESSO DI VOLER RIUTILIZZARE UNO SPEZZONE DI CODICE PRODOTTO IN 
PRECEDENZA, ALL'INTERNO DI UN NUOVO PROGETTO. DOVE CERCARLO? CON GLI 
"SNIPPET" DI VISUAL STUDIO È POSSIBILE MANTENERE UN ARCHIVIO MOLTO PARTICOLARE. 




"D 



ove l'avevo messo?" - Questa è la 
I "fatidica" domanda che ogni 
programmatore si pone un gior- 
no sì e l'altro ... pure. A chiunque di noi con 
un minimo di anni di esperienza sulle spalle è 
capitato di affrontare e risolvere con successo 
dei problemi specifici: aprire una connessio- 
ne a un particolare database, impostare un 
controllo in una certa maniera ecc.. 
Il problema è che, quando ci troviamo davan- 
ti allo stesso problema, ci ricordiamo sì, vaga- 
mente, che la cosa "non ci è nuova", che da 
qualche parte dovremmo aver già scritto il 
codice che ci tornerebbe proprio comodo, ma 
alla fine, spesso, ci rassegniamo e comincia- 
mo tutto daccapo. 

È per far fronte a questo problema che 
Microsoft ha inserito in Visual Studio 2005 
(anche nelle versioni Express) un utile stru- 
mento chiamato frammenti di codice o, molto 
più simpaticamente, in inglese snippets. 



Per prima cosa, in un progetto di Visual Studio 
o di Visual Studio Express, aggiungiamo una 
nuova classe, come in figura 1. 
Impostiamo quindi un metodo vuoto che 
compie Fazione di criptazione del file: 

Public Sub EncryptFile(ByVal filename As String, 

ByVal textToEncrypt As String) 
End Sub 

All'interno del corpo del metodo (nella riga 
vuota) facciamo clic con il tasto destro del 
mouse in modo di visualizzare il pop-up come 
in Figura 2 : 



3 Public Class Cryptor 

k Public Sub EncryptFile (Ev filename , textToEncryp 

L End C 
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Fig. 2: Inserimento del frammento di codice 
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COSA SONO GLI 
SNIPPETS 

Per capire cosa sono gli snippets la cosa 
migliore è provarli. 

Poniamoci quindi un obiettivo "reale" dicia- 
mo che il nostro scopo sarà quello di costrui- 
re una classe, in Visual Basic , che ha il compi- 
to di criptare e decriptare un file di testo. 
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Al primo posto, tra le voci di menu, troviamo 
proprio quella che fa al caso nostro : "Inserisci 
frammento di codice". Se clicchiamo su que- 
sta voce apparirà una struttura a cartelle 
come quella mostrata in Figura 3. 



B Public Class Cryptor 

è Public Sub EncryptFile (ByVal filename As String, ByVal te» 



Inserisci (rammento di codice: Protezione 

End Sub _j Applicazione - Compilazione , -: i se e impostazioni 

L End Class 



□ Applicazioni Windows Form 

■£l Connettività e rete 

Dan ■ Funzionalità della Finestra di progettazione e ADO.NET 

d File system - Elaborazio ie di u «ì 1 à cartelle e file 

_J Insiemi e matrici 

_i Matematica 

_ Modelli comuni di codice 



4 



, Sistema operative. Windows 



_zl 



Fig. 1: Aggiunta di una classe al progetto 



Fig. 3: Libreria di frammenti di codice per argomento 

Di qui scegliamo la cartella Protezione (in 
inglese Security) e l'apriamo con doppio clic 
per mostrare i frammenti che contiene, come 
vediamo in Figura 4. 
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dice: Protezione > 



yptFile (ByVal filename As String, ByVal textTo 



(=) Calcola il codice hash di una password 

. J\ Calcola il codice hash di una stringa 

=) Esegui la decrittografia del testo da un file 

IH Genera dati casuali di crittografia 

_=] Trova il nome dell'utente corrente 



Esegue la ( 
Tasto di se 



Fig. 4: Frammenti di codice per l'argomento selezionato 

Qui scegliamo il frammento (snippet) dal tito- 
lo "Esegui la crittografia di una stringa". 
Notiamo anche che lo snippet ha un Tip che ci 
informa sul contenuto del codice e sulla pos- 
sibilità di utilizzare un tasto di scelta rapida 
per l'operazione di inserimento. Questo vuol 
dire che possiamo inserire direttamente il 
frammento di codice direttamente scrivendo 
il nome di scelta rapida (in questo caso 
secEncrypt) e premendo il tasto TAB. 
Una volta cliccato il nome corrispondente al 
frammento di codice verrà inserito il codice 
corrispondente nel punto dell'Editor dov'è 
posizionato il cursore, Figura 5. 



dice: Protezione > 



yptFile (ByVal filenarae As String, ByVal textTo 



\=l Calcola il codice hash di una password 

. J\ Calcola il codice hash di una stringa 

=) Esegui la decrittografia del testo da un file 

1=] Genera dati casuali di crittografia 

S\ Trova il nome dell'utente corrente 



Esegue la ( 
Tasto di se 



Fig. 5: Il frammento di codice inserito 

Notiamo che ci sono delle parti di codice evi- 
denziate in verde che sono quelle che devono 
essere adattate al caso corrente e che, in testa 
al codice, vengono inseriti automaticamente 
gli imports necessari per gli spazi di nomi uti- 
lizzati. Questo non è un articolo sulla critto- 
grafia, per cui non ci soffermiamo a descrive- 
re tutti i passaggi del codice. Ci limitiamo a 
dire che, nella nostra classe, è necessario 
implementare un metodo che trasformi una 
password in una chiave e un vettore (matrici 
di byte) validi per l'algoritmo utilizzato. 
Nel nostro caso abbiamo fatto così: 

Private _Password As String = "password" 
Public Property Password() As String 

Get 

Return _Password 

End Get 

Set(ByVal Value As String) 

_Password = Value 

End Set 

End Property 

Private ReadOnly Property Key() As Byte() 
Get 



Return 
System. Text. Encoding. UTF8.GetBytes(Password.Pa 

dRight(32, " = ")) 

End Get 

End Property 

Private ReadOnly Property IV() As ByteQ 



Get 



Return 
System. Text. Encoding. UTF8.GetBytes(Password.Pa 

dRight(16, " = ")) 



End Get 



End Property 

Quindi andiamo a modificare il codice inseri- 
to dallo snippet inserendo i valori corretti nei 
segnaposti e otteniamo il nostro metodo: 

Public Sub EncryptFile(ByVal filename As String, 
ByVal textToEncrypt As String) 
Dim fStream As FileStream = 
File.Open(filename, FileMode.OpenOrCreate) 



Dim RijndaelAIg As Rijndael 



Rijndael. Create 



Dim cStream As NewCryptoStream(fStream, 



RijndaelAIg. CreateEncryptor(Me.Key, Me. IV), 



CryptoStreamMode.Write) 



Dim sWriter As New StreamWriter(cStream) 
sWriter.WriteLine(textToEncrypt) 



sWriter.CloseQ 



cStream.Close() 



fStream.CloseQ 



End Sub 

Per la decriptazione di un file codificato in 
una stringa, operazione inversa, impostiamo, 
anche qui, una funzione vuota: 

Public Function DecryptFile(ByVal filename As 

String) As String 
End Function 

Anche per questa operazione possiamo utiliz- 
zare uno snippet già pronto: "Esegui la decrit- 
tografia di un testo da un file" da inserire nel 
corpo della funzione che, opportunamente 
adattata, si presenterà così: 

Public Function DecryptFile(ByVal filename As 

String) As String 
Dim fStream As FileStream = 
File. Open(fi lena me, FileMode.OpenOrCreate) 



Dim RijndaelAIg As Rijndael 



Rijndael. Create 



Dim cStream As New 



CryptoStream(fStream, 




RISORSE 
SUL WEB 

Un buon articolo, per 
iniziare, è pubblicato in 
http:llmsdn.microsoft. e 
om/library/defaultasp ? 
url-llibrarylen- 
us/dnvs05/html/codesni 
ppets.asp 
In genere 

http:llmsdn.microsoft. e 
om/library rappresenta 
la reference principale 
per questa tecnologia. 



Rijndael Alg.CreateDecryptor(Me.Key, Me. IV), 
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CryptoStreamMode.Read) 



Dim sReader As New 



StreamReader(cStreaim) 



Dim plainText As String 



sReader.Readl_ine() 



sReader.Close() 



cStream.CloseO 



fStreaim.CloseQ 



Return plainText 



End Function 



ANATOMIA DI UNO 
SNIPPET 

Fin qui abbiamo visto come utilizzare gli snip- 
pets offerti dall'ambiente di Visual Studio (che 
già di per sé sono un buon numero). 
Il vero punto di forza di questa tecnologia sta 
però nel fatto di poter scrivere dei propri snip- 
pet con il codice che utilizziamo più frequen- 
temente. Prendiamo, ad esempio, la classe 
che abbiamo visto prima, per la criptazione e 
decriptazione di testo in un file. Per le opera- 
zioni principali siamo stati aiutati dagli snip- 
pet predefiniti, tuttavia alcuni passi del codi- 
ce li abbiamo dovuti inserire a mano: in parti- 
colare la trasformazione di una password di 
testo in una matrice di Byte. Quest'azione 
potrebbe essere utile anche altre volte, quindi 
potrebbe essere un buon candidato per un 
nuovo snippet. Visual Studio offre uno stru- 
mento per gestire gli snippets, si trova sotto il 
menu strumenti alla voce "Gestione fram- 
menti di codice", Figura 6. 



Strumenti Finestra Comunità 



[^ Connetti a processo. 



CTRL+ALT+P 



?^ Connetti al database. 



E 



Gestione frammenti di codice. . . CTRL+Kj CTRL+B 



Scegli elementi della Casella degli strumenti. 



Gestione componenti aggiuntivi., 



Fig. 6: Gestione frammenti di codice 

La finestra di gestione relativa è molto sempli- 
ce, Figura 7, e consente di impostare, aggiun- 
gere o rimuovere elementi o gruppi di ele- 
menti.Notiamo che, selezionando uno sni 
pet, appare anche il relativo percorso del file 
su disco con estensione .snippet . 
Se andiamo a visualizzare il contenuto della 
directory a cui appartiene il file vediamo che, 
in questo caso, il file dello snippet è insieme a 
tutti gli altri concernenti lo stesso argomento. 
Se apriamo un file, ad esempio quello della 
crittografia di una stringa, notiamo che lo 



B3B— B 



Ex] 



Linguàggio; 
(visual Basic 



~3 



C:\Prograrnmi\Microsoft Visual Studio 3\Vb\bnipGst:A10^Ci\5ecuNtv'\Ericryp?aii:!'!nQ,snipoet 



+ _, File system Elaborazione di unità, carb -»> i 

+ _j Insiemi e matrici 

É-Q Matematica 

É--Q Modelli comuni di codice 
_j My Code 5nippets 

E-k5 Protezione 

Calcola ii codice hash di una passio 
Calcola il endici- h.-;h di una --fcnnqb 

i=! Esegui la decrittografia del testo da 
Genera dati casuali di crittografia 
Trova il nome dell'utente corrente 

I 



Descrizione 

Esegue la crittografia di un testo eie un l : i!e 
utilizzando l'algoritmo di crittografia R.ijndae!, 

Collegamento 

secEncrypt 



nte t| 



J. 
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Fig. 7: La finestra di gestione degli snippet 

stesso è, in realtà, in formato XML: 

<?xml version = "1.0"?> 
<CodeSnippets 

xmlns= "http://schemas.nn icrosoft.com/VisualStudi 
o/2005/CodeSnippet"> 
<CodeSnippet Format="1.0.0"> 
<Header> 
<Title>Esegui la crittografia di una 

stringa</Title> 
<Author> Microsoft Corporation </Author> 
<Description>Esegue la crittografia di un 

testo da un file utilizzando l'algoritmo di 
crittografia Rijndael.</Description> 
<Shortcut>secEncrypt</Shortcut> 
</Header> 



<Snippet> 



<References> 



<Reference> 



<Assembly> System. Security.d II </Assembly> 



</Reference> 



</References> 



<Imports> 



<Import> 



<Namespace> Microsoft. Visual Basic</Namespace> 



</Import> 



<Import> 



<Namespace>System.IO</Namespace> 



</Import> 



<Import> 



<Namespace>System.Security.Cryptography</N 

mespace> 



</Import> 



</Imports> 



<Declarations> 



<Literal> 



<ID>fileName</ID> 



<Type>String</Type> 



<ToolTip>II nome del file contenente il 

testo crittografato.</ToolTip> 
<Default>"encrypted.txt"</Default> 



</Literal> 



<Object> 
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<ID>privateKey</ID> 



<Type>Byte</Type> 



<ToolTip>La chiave privata utilizzata per 

crittografare i dati.</ToolTip> 
<Default>RijndaelAlg.Key</Default> 



</Object> 



<Object> 



<ID>initializationVector</ID> 



<Type>Byte</Type> 



<ToolTip>II vettore di inizializzazione 
utilizzato nello schema di crittografia con chiave 

simmetrica. 



</ToolTip> 



<Default>RijndaelAlg.IV</Default> 



</Object> 



<Literal> 



<ID>plainText</ID> 



<Type>String</Type> 



<ToolTip>La variabile di tipo stringa 
contenente il testo da crittografare. </ToolTip> 
<Default>"Text to encrypt"</Default> 



</Literal> 



</Declarations> 



<Code Language="VB" Kind = "method 
body"x![CDATA[Dim fStream As FileStream = 
File.Open($filename$, FileMode.OpenOrCreate) 



Dim RijndaelAIg As Rijndael 



Rijndael. Create 



Dim cStream As New 



CryptoStream(fStream, 



RijndaelAIg. CreateEncryptor($privatekey$, 
$initializationVector$), _ 



CryptoStreamMode.Write) 



Dim sWriter As New StreamWriter(cStream) 



sWriter.WriteLine($plainText$) 



sWriter.Close() 



cStream.Close() 



fStream.Close()]]x/Code> 



</Snippet> 



</CodeSnippet> 



</CodeSnippets> 

La sintassi è molto semplice (tra l'altro Visual Studio 
offre anche il supporto di intellisense per la modifi- 
ca degli snippets). L'elemento CodeSnippets è quel- 
lo di primo livello, e contiene uno o più elementi 
CodeSnippet che costituisce l'elemento base per 
definire il nostro frammento di codice. 
CodeSnippet si articola in due sotto -elementi: 

1. Header che contiene le informazioni descrittive 
del frammento 

2. Snippet che contiene il codice e gli altri elementi 
utili a definirne il contesto 



r Nome elemento 


Tipo 


Descrizione 


Min./MaO 


Author 




facoltativoNome dell'autore 


0/1 


Description 


facoltativo 


Descrizione del frammento 
che appare nel Tooltip 


0/1 


HelpURL 


facoltativo 


URL Contenente ulteriori 
informazioni 


0/1 


Keywords 


facoltativo 


Contiene elementi Keyword, 
ovvero parole chiave 
personalizzate a scopo di 
ricerca o categorizzazione 


0/1 


Shortcut 


facoltativo 


Testo di collegamento 
utilizzabile per inserire il 
frammento con l'operazione: 
<testo>+TAB 


0/1 


SnippetTypes 


facoltativo 


Contiene elementi 
SnippetType che specificano il 
comportamento dello snippet 


0/1 


Title 


obbligatorio 


Nome dello snippet come 
appare in Intellisense 


1/1 



È da notare qui l'elemento SnippetTypes che 
contiene elementi di tipo SnippetType. I valo- 
ri di un elemento SnippetType possono esse- 
re: 

• SurroundsWith: permette di inserire il 
frammento di codice intorno a un segmen- 
to di codice. 

• Expansion: permette di inserire il frammento 
di codice nella posizione del cursore. 



L'ELEMENTO SNIPPET 

L'elemento snippet è più articolato e permet- 
te di definire, oltre al codice vero e proprio, il 
contesto dove esso si colloca. 
Qui possiamo avere i gruppi di elementi: 

• eferences 

• Import 

• Declarations 

• Code 

L'elemento References definisce i riferimenti 
(a librerie di sistema o personali) che verran- 
no aggiunti automaticamente al progetto (se 
non già presenti) al momento in cui si inseri- 
sce il frammento. 

Tali riferimenti sono definiti in un numero 
illimitato di sotto-elementi Reference che 
contengono: un elemento Assembly per defi- 
nire il nome dell' assembly che verrà aggiunto 
al progetto e, opzionalmente, un elemento Uri 
contenente l'indirizzo web dove è possibile 
trovare informazioni sull' assembly aggiunto. 
Ad esempio: 



L'ELEMENTO HEADER 

In Header possono essere contenuti gli elementi: 



<References> 



<Reference> 



<Assembly> System. Security.d II </Assembly> 
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i 



.net 




UM TOOL PER 

LA CREAZIONE 

DI SNIPPET 

All'indirizzo 

http://www.gotdotnet.c 

om/Workspaces/Worksp 

ace.aspx?id=a927f4e7- 

8e7f-45ce-8b72- 

f3b9384a3eab è 

pubblicato uno 

strumento visuale 

che consente 

l'editing degli 

snippets. 

Personalmente lo 

ritengo ancora non 

sufficientemente 

maturo (a volte 

inspiegabilmente 

sparisce il codice 

inserito e ci sono 

anche altri Bug) e poi 

Visual Studio offre 

già il supporto 

Intellisense per 

l'editing degli 

snippets quindi 

perché complicare le 

cose? 



< Uri > http ://www. microsoft. com</U ri > 
</Reference> 
</References> 

L'elemento Imports , invece, definisce gli 
spazi dei nomi che vengono automaticamen- 
te aggiunti in testa al file di codice utilizzando 
lo snippet, questo evita di dover far riferimen- 
to al nome completo dei tipi nel codice che 
andremo a definire. Imports contiene più ele- 
menti Import che, sotto l'elemento 
Namespace, definiscono lo spazio dei nomi 
relativo. Ad esempio: 

<Imports> 

<Import> 
< Namespace > Microsoft. Visual Basic</Namespace> 

</Import> 
</Imports> 

L'elemento Declarations è invece importante 
perché definisce i valori letterali o gli oggetti 
del frammento di codice che l'utente può 
modificare (quelli che vengono evidenziati in 
verde). Segnaposto dei valori effettivi. 
Tali valori sono espressi da due tipi di elemen- 
ti: Literal per i valori letterali e Object per gli 
oggetti. Ad esempio: 

<Declarations> 
<l_iteral> 
<ID>fileName</ID> 
<ToolTip>II nome del file contenente il 

testo crittografato.</ToolTip> 
<Default>"encrypted.txt"</Default> 
</l_iteral> 
<Object> 
<ID>privateKey</ID> 
<Type>Byte</Type> 
<ToolTip>La chiave privata utilizzata per 

crittografare i dati.</ToolTip> 
<Default>RijndaelAlg.Key</Default> 
</Object> 



nire noi nell'elemento Code, vedi successiva- 
mente). Ad esempio : $fileName$. 

L'elemento Code è, naturalmente quello più 
importante, perché racchiude il nostro codi- 
ce. Tale elemento ha tre attributi: 

• Delimiter (facoltativo) - specifica il delimi- 
tatore utilizzato per descrivere i valori lette- 
rali e gli oggetti nel codice. Se non altrimen- 
ti definito, il delimitatore è $. 

• Kind (facoltativo) - specifica il tipo di codi- 
ce contenuto nel frammento e pertanto le 
posizioni in cui il frammento può essere 
inserito. I valori disponibili sono; 

• method body - il frammento deve essere 
inserito all'interno di una dichiarazione di 
metodo 

• method deci - il frammento deve essere 
inserito all'interno di una classe o un 
modulo 

• type deci - il frammento deve essere inseri- 
to all'interno di una classe, un modulo o 
uno spazio dei nomi 

• page - il frammento di codice deve essere 
utilizzato come codice all'interno di una 
pagina di progetto Web 

• file - il frammento è un file di codice com- 
pleto 

• any - il frammento può essere inserito in 
qualsiasi posizione 

• Language (obbligatorio) - specifica il lin- 
guaggio del frammento di codice. I valori 
disponibili sono; 

• VB 

• CSharp 

• VJSharp 

• XML 

All'interno dell'elemento Code viene inserito 
il codice vero e proprio, preferibilmente 
all'interno dei tag <![CDATA[ ...]]> per evitare 
che alcuni simboli presenti nel codice (ad 
esempio < o >) possano essere interpretati 
come XML. 



Ogni elemento Literal o Object deve definire 
un elemento ID che possa essere richiamato 
nel codice e un elemento Default che contie- 
ne il valore predefinito. È possibile anche defi- 
nire un elemento ToolTip che verrà mostrato 
quando l'utente si sposta sul segnaposto per 
descrivere l'oggetto o il valore. Per gli elemen- 
ti Object è obbligatorio anche il sotto-elemen- 
to Type che definisce il tipo a cui appartiene 
l'oggetto. All'interno del codice possiamo 
inserire un segnaposto definito come Literal o 
Object attraverso il suo ID racchiuso tra il 
simbolo $ (o altro simbolo che possiamo defi- 



IL MOSTRO SNIPPET 

A questo punto possiamo procedere a creare il 
nostro snippet. Il suo scopo, abbiamo detto, sarà 
quello di generare un frammento di codice utile 
a trasformare una stringa in matrice di Byte da 
utilizzare come vettore o chiave di un algoritmo 
di criptazione. Nel nostro codice inseriremo 
anche alcune proprietà di sola lettura utili per 
restituire le matrici adatte per l'algoritmo 
Rijndael. Per prima cosa creeremo, con qualsiasi 
editor di testo, anche con lo stesso Visual Studio, 
un file XML con estensione .snippet. Se il file 
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verrà creato nella stessa directory che ospita gli 
altri snippet relativi alla sicurezza (nel mio caso 
"C: \ Programmi \ Microsoft Visual Studio 
8\VB\Snippets\1040\ Security") lo snippet appa- 
rirà accanto agli altri visti in precedenza. La 
sezione Header dello snippet apparirà quindi 
così: 

<Header> 



<Title>Genera matrice di byte da 



Stringa</Title> 



< Author> Francesco Smelzo</Author> 
<Description>Trasforma una stringa in 

matrice di Byte da utilizzare come vettore o 

chiave di un algoritmo di criptazione e genera 

metodi di esempio</Description> 



<Shortcut>strByte</Shortcut> 



</Header> 

L'elemento Shortcut, lo ricordiamo, ci permette 
di definire una scelta breve da tastiera. Quando 
progettiamo uno snippet dobbiamo pensare 
all'utilizzo in un contesto. In questo caso il codi- 
ce presuppone che ci sia, da qualche parte nella 
classe, una variabile o proprietà di tipo String da 
trasformare. A priori non possiamo saperne il 
nome quindi definiremo un segnaposto nell'ele- 
mento Snippet: 

<Snippet> 

<Declarations> 
<l_iteral> 
<ID>strVarname</ID> 



<ToolTip>Nome variabile 



stringa </ToolTip> 



<Default> Password </Default> 



</l_iteral> 

Tale elemento dovrà essere indicato, nel codi- 
ce, tra i delimitatori $ e, nel frammento, assu- 
merà inizialmente il valore indicato in 
Default. L'utente modificando tale valore e 
premendo il tasto Freccia Giù cambierà auto- 
maticamente il valore in tutte le parti del 
codice. Impostiamo, anche se non sarebbe 
strettamente necessario, altri due segnaposto: 
per il carattere di riempimento da utilizzare 
nel padding della stringa (se la password è più 
corta del numero di caratteri necessari alla 
matrice di byte la stringa viene riempita con 
tale carattere, altrimenti viene troncata) e per 
il tipo di encoding da utilizzare. Richiamiamo 
qui soltanto l'elemento Code, lo snippet com- 
pleto (insieme ad altri che possono risultare 
utili) sono contenuti nel codice allegato: 

<Code Language="VB" Kind = "method ded"> 
<![CDATA[ 



Private Function 
$strVarname$ToBytes(maxl_ength as Integer) As 

ByteQ 

If String. IsNullOrEmpty($strVarname$) 

Then 
$strVarname$="EmptyPassword" 
End If 



Dim b() as Byte 



$Encoding$.GetBytes($strVarname$.PadRight(ma 
Length, $PadChar$)) 



Return b 



End Function 



Public ReadOnly Property RijndaelGetKey 

()As ByteQ 



Get 



Return $strVarname$ToBytes(32) 



End Get 



End Property 



Public ReadOnly Property RijndaelGetlV ()As 

ByteQ 



Get 



Return $strVarname$ToBytes(16) 



End Get 



End Property 



]]></Code> 

Non resta, a questo punto che provare il nostro 
snippet. Nell'editor di Visual Studio, nel corpo di 
una classe digitiamo strByte + TAB e vediamo il 
nostro frammento apparire, come in Figura 8. 
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Fig. 8: Il nostro frammento inserito 



CONCLUSIONI 

In questo articolo abbiamo visto la tecnologia 
degli snippets di Visual Studio. Uno strumento, 
tutto sommato, semplice e pratico da gestire che 
ci consente di mettere un po' d'ordine nel nostro 
codice e, possibilità non secondaria, condivider- 
lo con altri. 

Provate a sviluppare i vostri snippets e vedrete 
che non potrete più farne a meno! 

Francesco Smelzo 
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APPLICAZIONI WEB 
CON GLI ACTIVEX 

ECCO LE TECNICHE DA USARE PER SVILUPPARE SITI WEB DINAMICI UTILIZZANDO VISUAL 
BASIC. COME ESEMPIO APPLICATIVO DESCRIVEREMO COME PUBBLICARE SUL WEB UN 
CATALOGO DI FOTOGRAFIE USANDO UN ACTIVEX ED UN DATABASE ACCESS. 




□ . 



CD J WEB 

activevb.zip 





REQUISITI 



■ iim i ■ ii'ii' i ^m 

rr US, WebClass, Controlli 
' — ' Activex. 



Piattaforma Windows 
2000 o superiore - US 
(Internet Information 
Server) - Visual Basic 6 
SP6. 



_J_J_J 

0000 



Tempo di realizzazione 



& 



upponiamo di volere sviluppare un sito web 
dinamico in Visual Basic. Come fare? Le solu- 
zioni possibili sono molte. Potremmo sceglie- 
re di sviluppare un Isapi, overo un DLL che richia- 
mata dal browser, con certi parametri produce in 
output una pagina particolare. Oppure potremmo 
usare DHTML, oppure una tecnologia quale quella 
degl Activex Document. In questo articolo utilizze- 
remo appunto quest'ultimo metodo per pubblicare 
un catalogo fotografico con tanto di browsing delle 
foto organizzato in categorie e sotto categorie. 



CHE COSA E UM'ACTIVEX 
DOCUMENT 

Sostanzialmente si tratta di una normale o quasi , 
applicazione molto simile ad un'applicazione tra- 
dizionale, il cui contenitore è però Internet 
Explorer. Per certi versi potete immaginarli come 
le vecchie applet Java. In realtà gli Activex 
Document sono delle applicazioni che possono 
essere eseguite in maniera generica attraverso dei 
contenitori di Activex. Ricordiamo che i conteni- 
tori principali di Activex sono Microsoft Internet 
Explorer e Microsoft Office Binder (raccoglitore di 
Office). 

Gli Activex Document uniscono le funzionalità di 
un'applicazione alla flessibilità dei documenti. Gli 
Activex Document sono delle applicazioni che si 
comportano come dei documenti con contenuto 



E ALTERNATIVE AD ACTIVEX DOCUMENT 



Le US e le DHTML application, sono 
una combinazione di codice Visual 
Basic e HTML, e sono eseguite in un 
Browser come le applicazioni HTML 
e ASP. Per implementare ed 
utilizzare un'applicazioni MS è 
necessario un Server Web per le 
DHTML, invece, non è necessario 
dato che sono delle applicazione 
Client. Le MS sono eseguite sul 



Server e rispondono alle richieste 
del Browser, le DHTML, invece, 
risiedono sullo stesso computer su 
cui si trova il Browser. Le MS sono 
implementate con WebClass e 
pagine ASP (Active Server Pages). 
Come vedremo, le WebClass 
permettono d'implementare 
efficientemente e velocemente 
applicazioni Server per Internet. 



dinamico. La compilazione di un progetto docu- 
mento Activex produce il file che deve essere uti- 
lizzato nel contenitore di Activex e il file che forni- 
sce le funzionalità (i servizi) al documento e quin- 
di lo rende indipendente dal contenitore. La crea- 
zione di un Activex Document è analoga alla crea- 
zione di un Controllo Activex standard. Per i docu- 
menti Activex sono disponibili due tipi di proget- 
to: Activex Document Dll (in-process component) 
e Activex Document Exe (out-of-process compo- 
nent). Il primo tipo di progetto ha come prodotto 
una DLL il secondo un file .EXE, in entrambi i casi 
però viene anche prodotto almeno un file con 
estensione .vbd che è quello che verrà mostrato 
nel contenitore. Il file .vbd all'atto della compila- 
zione è posto nella stessa directory del file EXE o 
DLL prodotto. Naturalmente il file vbd senza il file 
EXE o DLL non può essere eseguito. 



CONTROLLI ACTIVEX 

Come sappiamo, in Visual Basic, alla base della 
programmazione per componenti c'è l'architettu- 
ra ad oggetti COM (Component Object Model) che 
fornisce un protocollo per definire dei componen- 
ti riutilizzabili. I controlli Activex definibili dall'u- 
tente rientrano in questa strategia. Con Visual 
Basic è possibile implementare diversi tipi di 
Activex tra i quali quelli pubblicabili su Internet 
che introdurremo nei successivi paragrafi. Alla 
base di un progetto Activex c'è l'oggetto 
UserControl esso, analogamente ad una form, 
presenta una finestra di progettazione, dove inse- 
rire i controlli che lo costituiscono e un modulo di 
codice, dove definire le proprietà, i metodi e gli 
eventi. Gli UserControl sono memorizzati in dei 
file con estensione ctl mentre dopo la creazione 
(Make) è costruito un file .OCX che può essere 
distribuito. Quando si crea un nuovo progetto 
Activex, le uniche proprietà disponibili sono quel- 
le di base dell'UserControl, le altre proprietà pos- 
sono essere aggiunte manualmente con la parola 
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chiave Property o attraverso il Wizard: "creazione 
guidata interfaccia controlli Activex" che si trova 
nelle aggiunte di Visual Basic. 



IL CATALOGO 
FOTOGRAFICO 

L'applicazione che permette di pubblicare un 
catalogo fotografico sarà costituita da un misto 
dato da un progetto Controllo Activex e un proget- 
to US. Le foto verranno organizzate secondo una 
gerarchia con due livelli - categorie e sottocatego- 
rie - archiviata in un Database Access (nominato 
Catalogo). Per semplificare nel Database inserire- 
mo una sola tabella nominata Catalogo descritta 
in Tabella 1. 

Le immagini del catalogo, invece, non saranno sal- 
vate nel database ma in una directory locale o 
remota. Come vedremo avanti, la posizione di 
questa directory è specificata attraverso un para- 
metro dell'UserControl. Le immagini sono asso- 
ciate ai record del database attraverso il loro nome 
che, per il nostro esempio, deve essere uguale alla 
denominazione della categoria. In questo modo 
ad ogni categoria è associata un'immagine se, 
invece, volessimo un'immagine per ogni sottoca- 
tegoria le immagini dovrebbero essere nominate 
come categoria- sottocategoria, ecc. Nei paragrafi 
successivi introduciamo i progetti alla base del- 
l'applicazione, questi esempi li trovate nel CD alle- 
gato alla rivista. 



IL PROGETTO ACTIVEX 

L'Activex per Internet della nostra applicazione, 
permette di scorrere e visualizzare delle immagini, 
il cui nome è specificato nella tabella Catalogo. Le 
posizioni del database e delle directory delle imma- 
gini verranno specificati con due parametri. Di 
seguito per punti descriviamo come creare il con- 
trollo Activex. 



2Sull'UserControl inserite i controlli che permet- 
tono di visualizzare e scorrere i dati contenuti 
nel database. In particolare inserite: 3 textbox 
(nominati TxtCategoria, TxtSottoCategoria e 
TxtNote) per visualizzare il contenuto dei campi 
Categoria, Sottocategoria e Note; una PictureBox 




r 


Catalogo 




~N 


Campo 


Tipo 


Numero 


Contatore 


Categoria 


Testo (50) 


SottoCategoria 


Testo (50) 


Note 


Testo (250) 


^EE 



(PictureAnteprima) per visualizzare l'anteprima 
dell'immagine collegata al record; 2 
CommandButton (avanti e dietro) e un TextBox 
(TxtNumeroElementi) per controllare la sequenza 
dei record visualizzati. Tra l'atro prevedete una 
Label (LabelIE) da utilizzare per visualizzare, e clic- 
care, il path dell'immagine in anteprima. In parti- 
colare, cliccando su questa label faremo in modo 
che l'immagine si apra in Internet Explorer. 
Disponete il tutto come in figura. 



h 

Categoria 



QGRAMlffea 



SottoCategorie 



Mote 



Anteprima >> Path immagine 



Fig. 2: L'UserControl del progetto Activex 



1 



Create un nuovo progetto Activex (si con- 
trolli la figura 1) che referenzia la libreria 
MSADODB 2.5 




- y§^ Progetto 1 (Progetto 1) 

É-@Ì Controlli utente 

[jjj UserControll (UserControll) 



Proeettol -UserControll fUse... L"lfnll> 



Fig. 1: La struttura di un progetto Activex 



3 Nella parte dichiarativa dell'UserControl, biso- 
gna definire le seguenti variabili: 

'La parte dichiarativa... 

Private I As Integer 

Private Rstcatalogo As ADODB.Recordset 

Private pathimmaginehtml As String 

Private mvarpathdatabase As Variant 

Private mvarpathdirimmagini As Variant 



La variabile I indica la posizione relativa del record 
corrente; Rstcatalogo è il RecordSet caricato in 
memoria: pathimmaginehtml è il Path dell'imma- 
gine in anteprima; pathdatabase e pathdirimmagi- 
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ni sono i parametri che il controllo riceverà dalla 
pagina HTML che lo contiene. In particolare path- 
dirimmagini rappresenta il path della directory che 
contiene le immagini del catalogo, pathdatabase, 
invece, è il path del database Catalogo. 

411 codice per la definizione delle Property Get e 
Let dei parametri dell'UserControl è il seguente. 

Public Property Get pathdirimmagini() As Variant 
pathdirimmagini = mvarpathdirimmagini 

End Property 

Public Property Let pathdirimmagini(Byval 

vNewValue As Variant) 
mvarpathdirimmagini = vNewValue 

End Property 



Public Property Get pathdatabase() As Variant 
pathdatabase = mvarpathdatabase 
End Property 
Public Property Let pathdatabase(ByVal 

vNewValue As Variant) 
mvarpathdatabase = vNewValue 
End Property 



App.Path) 




ICAMENTO DI UN 'IMMAGINE 
IN MODALITÀ ASINCRONA 



Il caricamento di 
un'immagine in un 
UserControl può 
essere fatto anche in 
modo asincrono (cioè 
caricare l'immagine e 
nel frattempo 
effettuare altre 
operazioni). Questa 
caratteristica viene 
regolata dalle 
proprietà 

AsyncReadComplete e 
AsyncReadProgress. 



La sintassi del metodo 
AsyncRead è la 
seguente: 
object. AsyncRead 
Target, AsyncType [ f 
PropertyNameL 
[AsyncReadOptions] 
Target è l'URL da cui si 
esegue il DownLoad 
delle proprietà, nei 
nostri esempi 
dovrebbe essere il 
path dove si trova 
l'immagine da 



caricare. AsyncType è 
il tipo di proprietà di 
cui bisogna fare il 
DownLoad, i possibili 
valori sono: 
vbAsyncTypePicture 
(nel caso di 
un'immagine), 
vbAsyncTypeFile, 
vbAsyncTypeByteArra 
y. Property IMame è il 
nome delle proprietà 
di cui si esegue il 
Download. 



J 



5 Per gestire i valori dei parametri utilizziamo gli 
eventi UserControl_WriteProperties e 
UserControl_ReadProperties, nei quali prevediamo 
il seguente codice. 



Private Sub 



UserControl_ReadProperties(PropBag As 
PropertyBag) 
pathdatabase = 

PropBag.ReadProperty("pathdatabase") 
pathdirimmagini = 

PropBag.ReadProperty("pathdirimmagini") 
End Sub 
Private Sub 

UserControl_WriteProperties(PropBag As 
PropertyBag) 
Cali PropBag.WriteProperty("pathdatabase", 



Cali PropBag.WnteProperty("pathdirimmagini", 

App.Path + "/images") 
End Sub 

Con UserControl_ReadProperties si leggono i valo- 
ri delle Property forniti dal contenitore 
dell'UserControl, mentre conWriteProperties s'im- 
postano i valori di Default. 

6 Di seguito presentiamo il codice per collegarsi al 
database e per eseguire la query che legge tutte 
le categorie in catalogo. Questa query è impostata 
nell'evento UserControl_Show che è generato 
quando è visualizzato il controllo. 

Private Sub UserControl_Show() 

If pathdirimmagini = "" Then 
pathdirimmagini = App.Path 

End If 

If pathdatabase = "" Then 
pathdatabase = App.Path 

End If 

initdatabase ("select * from catalogo " _ 

& "order by categoria") 
End Sub 
Private Sub initdatabase(str As String) 

Dim strcnn As String 

strcnn = "Provider=microsoft.jet.oledb.4.0;" _ 



& "Data Source= 



" " & pathdatabase . 



& "\catalogo.MDB; 



Set Rstcatalogo = New ADODB.Recordset 
Rstcatalogo.CursorType = adOpenKeyset 
Rstcatalogo. LockType = adLockOptimistic 
Rstcatalogo. Open str, strcnn, , , adCmdText 
impostadati (1) 
End Sub 



Notate che alla initdatabase la query è passata con 
la stringa Str. Il codice della initdatabase si collega 
al database ed in base alla query carica Rstcatalogo, 
infine invoca la impostadati per caricare i dati nei 
controlli dell'UserControl. La impostadati è descrit- 
ta di seguito. 



7 



Il codice dell'impostadati e quello per scor- 
rere i Record con i pulsanti avanti e dietro è 
il seguente. 



Private Sub impostadati(Optional ind As Variant) 
If Not IsMissing(ind) Then 



I 



ind 



End If 



If Not Rstcatalogo. EOF Then 



With Rstcatalogo 



txtcategoria = Icategoria 



txtsottocategoria = Isottocategoria 



txtnota = !note 
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LabelIE.Visible = False 



DocPicture.Picture = Nothing 



txtnumeroelementi 



CStr(I) + 7" + 

CStr(.RecordCount) 



On Error GoTo fine 



DocPicture.Picture 



LoadPicture(pathdirimmagini 



"\" & txtcategoria + ".jpg") 



pathimmaginehtml = pathdirimmagini &_ 



"\" & txtcategoria + ".jpg" 



LabelIE.Caption = ">> " + pathimmaginehtml 



LabelIE.Visible = True 



fine: 



End With 



End If 



End Sub 



Private Sub Avanti_Click() 



If Not Rstcatalogo.EOF Then 



On Error GoTo fine 



1 = 1+1 



If I > Rstcatalogo.RecordCount Then 



I = Rstcatalogo.RecordCount 



Else 



Rstcatalogo. MoveNext 



impostadati 



End If 



End If 



fine: 



End Sub 



Private Sub Dietro_Click() 



If Not Rstcatalogo.EOF Then 



1 = 1-1 



If I <= Then 



I = 1 



Else 



On Error GoTo fine 



Rstcatalogo. MovePrevious 



impostadati 



End If 



End If 



fine: 



End Sub 

La impostadati inserisce i valori nei TextBox, nel 
PictureBox ed imposta la LabelIE. In particolare txt- 
numeroelementi indica il record corrente sul 
numero dei record caricati in Rstcatalogo. Il valore 
di txtnumeroelementi sarà modificato in base al 
valore della variabile I. 



8 



Per ricercare un particolare Record e per visua- 
lizzare l'immagine con Internet Explorer, utiliz- 
ziamo il seguente codice. 



Private Sub Cerca_Click() 



Dim QUERY As String 



QUERY = "Select * from catalogo where " _ 
& "categoria " & "like '%" & txtcategoria & "%" 



If txtsottocategoria <> "" Then 



QUERY = QUERY & " and sottocategoria = 



& txtsottocategoria & "'" 



End If 




CancellaCampi 



initdatabase (QUERY) 



ISUi 

Basic 



End Sub 



Private Sub CancellaCampiQ 



txtcategoria 



txtsottocategoria 



txtnota 



LabelIE.Visible = False 



DocPicture.Picture = Nothing 



TAG SCRIPT 



In una pagina HTML è possibile inserire del codice VBScript 
utilizzando il Tag Script. Per esempio, se create un file HTML ed in 
esso inserite le seguenti istruzioni, potete aprire il sito 
www.ioprogrammo.it. 



<HTML> 



<script language="Vbscript"> 



Dim max 



max= msgbox ("Salve, vuoi aprire il sito" . 



& "di IoProgrammo",vbokcancel, "Esempio") 



if max=vbok then 



open "http://www.ioprogrammo.it" 



else 



Msgbox "ciao" 



end if 



</script> 



</HTML> 



End Sub 



Private Sub LabelIE_Click() 



Dim IEApp As Object 



Set IEApp = 

CreateObject("InternetExplorer.Application") 



IEApp. Visible = True 



IEApp. Navigate pathimmaginehtml 



IEApp. Height = 500 



IEApp. Width = 500 



IEApp. MenuBar = False 



IEApp. toolBar = False 



End Sub 



PAGINA HTML 
PER USERCOMTROL 

Per utilizzare un UserControl in una pagina HTML, 
possiamo procedere nel seguente modo. 

1 Creare FOCX con il commando File /Crea 
Progetto 1. OCX (facciamo notare, però, che il 
progetto Activex nel nostro esempio è stato 
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nominato Catalogo). 

2 Create una pagina HTML, simile alla seguente, 
con i riferimenti al controllo Progetto 1. OCX. 



<HTML> 


<BODY> 




«DBJECT 


classid=clsid:44BCAF42 . 


.> 






<param name= 


"pathdatabase" value= 


"C:\data"> 


<param name= 


"pathdirimmagini' 
value= 


"C:\data\images"> 


</OBJECT> 


</BODY> 


</HTML> 



INTERNET COMPONENT DOWNLOAD 



Internet Component 
Download (ICD) è il 
meccanismo che 
regola il 
downloading e 
l'istallazione del 
codice per internet. 
ICD è usato da 
Internet Explorer per 
il Download 
automatico e 
l'istallazione 
controllata del codice 
presente su Internet. 



In parole povere ICD 
si preoccupa di 
associare al controllo, 
presente sulla 
pagina, le DLL di 
supporto. Per 
esempio se su una 
pagina HTML è 
pubblicato un 
controllo Activex, che 
fa uso di alcuni 
controlli di base di 
Visual Basic, per la 
corretta esecuzione 



nel Browser sono 
necessari i file di 
RunTime di Visual 
Basic (Msstkprp.dll e 
VB6 Runtime and OLE 
Automation). Di 
come distribuire 
questi file, però, il 
programmatore non 
si deve preoccupare 
dato che ci pensa il 
Wizard di creazione 
guidata del pacchetti 
di installazione. 



3 Per creare la pagina HTML precedente, 
potete utilizzare un editor come Blocco 
Note salvando il file ottenuto con estensione 
htm. Notate che per inserire il controllo OCX in 
una pagina HTML bisogna utilizzare i Tag 
Object e Param. Classid, invece, è l'identifica- 
tore univoco del controllo. Naturalmente il 
clsid deve essere quello associato al vostro 



Generale | Crea j Compila | Componente Debug J 



C Attendi che vengano creati i componenti 


*• Avvia ilo -mD-jr lente: Catalogo 


A 


(~ Avvia il programma: 


1 


A 


C Avvia il browser con l'URL: 


1 


(^ Usa il browser esistente 



UserControl. Un modo banale per ricavare il 
clsid è copiarlo dalla pagina HTML creata da 
Visual Basic nella fase di Debug del controllo 
(selezionando sul Browser mostra origine 
HTML), oppure seguire le indicazioni fornite 
dal Wizard d'installazione. Infine notate che 
con i tag PARAM si specificano i valori dei 
parametri passati dalla pagina HTML al con- 
trollo. 



IL PROGETTO US 

Un controllo OCX per Internet può essere uti- 
lizzato su una semplice pagina HTML o ASP, 
come visto in precedenza, oppure inserito in 
una WebClass di un progetto US. Per passi illu- 
striamo come creare un progetto US che utiliz- 
za il nostro OCX. 

1 Create un Progetto US e salvatelo in una directory 
dedicata. 

2 Create una pagina HTML simile a quella presen- 
tata nei paragrafi precedenti e salvatela nella 
stessa directory in cui avete salvato il progetto. Nel 
nostro caso la pagina è stata nominata 
DocumentiWeb.htm e la trovate nel CD allegato alla 
rivista. 

3 Sulla maschera di progettazione della WebClass, 
selezionate il bottone (oppure utilizzate il tasto 
destro Mouse sul contenitore oggetti Webltem) 
aggiungi Webltem HTML, nella finestra che compa- 
re, selezionate il file HTML che avete creato in pre- 
cedenza. 





% Progetto 1 - DocumentiWeb (WebClass) 


yn||x| 


%|a|x| BlfflMfl ►!■! 


- 3 DocumentiWeb I Nome _| 


- s 

Lai 


Taglia CTRL+X 
Copia CTRL+C 
Incolla CTRL+V 


■ 


Aggiungi modello HTML.,. 
Aggiungi Webltem personalizzato 


Avvia Internet Information Server 
Interrompi Internet Information Server 


Visualizza codice INVIO 


< 







Fig. 3: La finestra per impostare il Debug del controllo 



Fig. 4: La finestra per impostare il modello HTML 

Dopo i passi precedenti sulla parte destra della fine- 
stra di progettazione della WebClass, compaiono dei 
riferimenti agli elementi principali della vostra pagi- 
na HTML. Questi elementi possono essere utilizzati 
a livello di programmazione solo dopo averli con- 
nessi a qualche evento personalizzato o a qualche 
Webltem. 
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ILe prime istruzione da eseguire all'avvio del 
progetto US, devono essere inseriti nell'evento 
WebClass_Start. 



grammo.it. Naturalmente per rendere funzionante 
l'esempio dovete impostare opportunamente i 
valori dei parametri del UserControl. 



Private Sub WebClass_Start() 



Set Nextltem = Templatel 



WEB SERVER 



End Sub 

Start insieme a Initialize, Begin Request, End 
Request, Terminate sono gli eventi fondamen- 
tali della WebClass. La proprietà Nextltem 
serve ad indicare qual'è il successivo Webltem 
da eseguire, in altre parole permette il passag- 
gio dell'elaborazione tra Webltem. Nel nostro 
caso il controllo è passato al Webltem 
Templatel, cioè alla pagina HTML che abbia- 
mo creato nel punto 2. 

5 Dopo che il controllo è passato al Templatel 
dobbiamo stabilire le azioni da eseguire. A tale 
proposito possiamo utilizzare il primo evento del 
Webltem eseguito, in pratica Respond che è l'even- 
to predefinito degli oggetti Webltem. 

Private Sub Templatel_Respond() 
With Response 

.Write "<html>" 

.Write "<body>" 

.Write "<a href = http:Wwww.ioprogrammo.it> " _ 

& "<font color=#EF8BlC> HOME 

ioProgrammo</a>" 

.Write "</body>" 

.Write "</html>" 
End With 

Templatel. WriteTemplate 
End Sub 



Nell'evento Templatel_Respond, tra l'altro, è utiliz- 
zato il metodo WriteTemplate che permette d'invia- 
re il modello HTML al Browser (dopo averlo elabo- 
rato). A questo punto il controllo OCX è mostrato 
sul Browser. Notate che sul Browser, oltre al con- 
trollo è inserito un collegamento al sito www.iopro- 



2 ; http://localhost/Proweb/Documenti,A5P 
ES^SHì" -; http://localhost/Pro... 



v] H Vai 



HOME ìoProgrammo 



tORoGB 



Cerca ■ « \\fil » 



Categoria 



SottoCategorie 



nt S a... (T|(n|@ 



UKima automobile 




Per poter creare o 
eseguire delle 
applicazioni US è 
necessario installare 
il Server Web 
compatibile con il 
sistema operativo 
della vostra 
macchina. Gli esempi 
presentati in questo 
articolo, sono stati 
sviluppati con la 



piattaforma Windows 
XP Professional - 
Internet Information 
Server (US) 5.1. 
Questi, però, con 
alcuni accorgimenti 
possono essere 
utilizzati anche con 
altri sistemi 
operativi. Ricordiamo 
che nel caso di 
Windows 95/98 il 



Server Web è 
Personal Web Server 
(PWS) che si trova 
nella suite Visual 
Studio oppure nella 
cartella add-ons del 
Cd del sistema 
operativo. Attenzione 
al fatto che il PWS 
installato deve essere 
nella stessa lingua di 
Visual Basic! 



CONCLUSIONI 

Nell'articolo non abbiamo dato spazio alle tecniche 
di protezione e sicurezza, tuttavia è innegabile che 
temi come questi siano da tenere in dovuto conto 
quando si sviluppano applicazioni per la rete. Prima 
di "deployare" un nuovo progetto, vi consigliamo 
sempre di eseguire uno studio approfondito dei 
possibili problemi legati ad applicazioni che devono 
essere esposte ad un largo numero di utenti. 

Massimo Autiero 



■IS E DIRECTORY VIRTUALI 



Web Server viene 
creata una directory 
virtuale il cui nome 
può essere scelto 
dal programmatore. 
Questa directory nei 
Browser è 
visualizzata come 
sottodirectory della 
directory principale 
del Server Web. Se il 
progetto Visual 
Basic non è salvato, 
la directory Virtuale 
assegnata 
dall'ambiente 
d'implementazione 
è la Temp. Dopo la 
creazione è possibile 
modificare il nome 
della directory 
virtuale ma non la 
sua posizione. Per 
vedere la directory e 
le sue 
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Fig. 1: La finestra nuovo 
progetto Visual Basic 

Le applicazioni US, o 
progetti MS, si 
creano dalla finestra 
NuovoProgetto 
scegliendo 
Applicazione MS, il 
progetto che si 
ottiene è di tipo DLL 
Activex e ha come 
componente di 
avvio un oggetto 
chiamato 

WebClassL All'avvio 
del progetto MS nel 



caratteristiche 
(Alias, permessi ...) 
basta selezionare le 
proprietà del Web 
Server e cliccare sul 
bottone 
impostazioni 
avanzate. S'intuisce 
che un'applicazione 
MS non può 
funzionare senza 
Web Server. 




Fig. 2: La directory Virtuale 
del progetto US della 
nostra applicazione 



Fig. 5: Il Progetto US in fase di esecuzione 
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PERSISTENZA DEI DATI 
CON CAYENNE 

NUMEROSI FRAMEWORK ORM PERMETTONO DI CREARE OGGETTI A PARTIRE DA BASI DI 
DATI E VICEVERSA. CAYENNE HA DELLE CARATTERISTICHE ESTREMAMENTE INTERESSANTI E 
UTILIZZABILI SIA PER PROGETTI AMATORIALI CHE PROFESSIONALI 





t Java, JDBC, Torneai 



» 



JDK 1.3 (o successivi). 
Driver JDBC per il 
database utilizzato 
(nell'esempio si fa uso 
diMySql) 






Tempo di realizzazione 



Qual è il problema dei database moder- 
ni? Sostanzialmente nessuno. Tutti 
sono affidabili, veloci e ciascuno espo- 
ne caratteristiche degne della tecnologia 
moderna. Ciò che unisce tutti i database è il 
fatto che sono pensati secondo un modello 
relazionale. I dati all'interno di un database 
sono organizzati in tabelle, ciascuna tabella è 
costituita da righe. Ciascuna riga è costituita 
da colonne. Le tabelle sono messe in correla- 
zione fra loro tramite un accoppiamento di 
colonne determinate. 

Potete pensare a un database come a un file 
excel. I fogli che compongono il progetto Excel 
potrebbero essere assimilati a tabelle, le righe 
del foglio a record, le intestazioni a colonne. 
Ora, il punto è che i dati all'interno di una 
database vengono manipolati tramite un lin- 
guaggio "SQL" che ragiona in termini di rela- 
zioni fra elementi delle tabelle, ad esempio: 

Select cmn.* , abt.* from comuni as cmn, 
abitanti as abt where 
abt.ID_COMUNE=cmn.ID_COMUNE; 

Un'espressione del genere per essere utilizzata 
all'interno di un linguaggio ad alto livello, 
dovrebbe essere utilizzata da un metodo 
"query" che esegue l'istruzione e ritorna una 
struttura idonea ad essere gestita dal linguag- 
gio. Questo tipo di approccio ha un enorme 
svantaggio, ovvero le colonne del db, così come 
le tabelle, così come le righe non sono oggetti 
dotati di proprietà e metodi bensì sono sempli- 
cemente un "dato" acquisito e manovrabile 
solo ancora una volta tramite istruzioni SQL. 
Per aggirare questo problema nascono gli ORM 
ovvero framework intermedi che si occupano 
di "mappare" le tabelle, le righe e le colonne, in 
corrispondenti oggetti manipolabili diretta- 
mente dal linguaggio. 

In questo articolo ci occuperemo di Cayenne, 
un ORM piuttosto avanzato che offre funzio- 
nalità di tutto rilievo. 



URI CASO CONCRETO: 
GESTIAMO Ul\l BLOG 

Si supponga di voler realizzare un'applicazio- 
ne Web per la gestione /visualizzazione di un 
blog. La nostra applicazione farà quello che 
fanno più o meno tutti i blog, sarà possibile 
inserire nuovi post (ognuno è caratterizzato da 
una data, un flag che indica la presenza o 
meno in home page, un titolo, un abstract e un 
contenuto vero e proprio). Per ogni post sarà 
possibile inserire dei commenti (specificando 
l'autore; la data del commento è quella del 
sistema). 

Preve deremo una pagina introduttiva, una di 
autenticazione, una di risorse ed una di visua- 
lizzazione dei post del blog. Nella pagina di 
visualizzazione del blog, dapprima sarano visi- 
bili solo alcuni post (quelli con flag "in_home" 
a "true") di cui verranno mostrati solo titolo e 
abstract. Ognuno di essi avrà un link che con- 
durrà a una pagina dove sarà mostrato l'inter- 
no post. Dalla pagina del blog dovrà essere 
possibile tramite un link, la visualizzazione dei 
titoli/ abstract di tutti i post inseriti. 
L'amministratore potrà eliminare sia dei post 
sia singoli commenti. Inoltre un utente auten- 
ticato come amministratore a mezzo di una 
form di login potrà inserire nuovi post e modi- 
ficare quelli esistenti 



PRIMA LA BASE DATI 
O IL MODELLO 
AD OGGETTI? 

Cayenne dispone di un tool grafico dal quale è 
possibile sia modellare le classi e conseguente- 
mente di generare script per il database, sia 
generare le classi a partire da una base dati esi- 
stente. In questo articolo seguiremo il secondo 
approccio. Questo perché di solito chi crea la 
base dati è un esperto di database ma non 
necessariamente un esperto di Cayenne. 
Pertanto è fondamentale creare una "buona" 
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base dati con gli strumenti con cui si ha più 
dimestichezza. 

Nella cartella dove è stato scompattato 
Cayenne è presente una cartella bin/. Al suo 
interno ci sono degli script per lanciare il 
modeler (.bat per sistemi Windows, .sh per 
quelli Linux). Esso si presenta con una console 
grafica. 

Prima di eseguire la creazione delle classi è 
bene inserire le informazioni per la connessio- 
ne al database selezionando Tools > 
Preferences. Su "Classpath" impostimo il file 
jar dei driver del database che si vuole utilizza- 
re; su "Locai DataSources" impostiamo le 
stringhe di connessione JDBC al database. Per 
verificare che tutto funzioni utilizziamo il pul- 
sante "Test"; se appare la scritta "Connected 
Succesfully" si è impostato tutto correttamen- 
te. Per rendere persistenti queste impostazio- 
ni è sufficiente usare il pulsante "Save". 
Ora si può creare un nuovo progetto; da "File" 
scegliendo "New Project" oppure aprire un 
progetto esistente. Per quanto riguarda questo 
articolo utilizzeremo un progetto esistente, 
disponibile nel codice allegato al CDRom, il file 
da aprire è cayenne.xml. Il primo nodo della 
gerarchia ("CayenneloProgrammo") è il nome 
del progetto. A seguire il DataNode creato e il 
DataMap associato. Il DataMap è il "cuore" 
della configurazione, ove risiedono tutte le 
informazioni di associazione tra tabelle e 
oggetti (entrambi gli oggetti sono inclusi nel 
datamap). 

Per creare altri data no de è sufficiente fare clic 
con il mouse sul nome del progetto e da 
"Project" scegliere "Create DataNode". 
Lasciare tutti i valori di default a meno della 
voce "Locai dataSource": selezionare quanto 
definito in precedenza sulle preferenze del 
tool. Fatto questo premere sul pulsante "Sync 
with locai": i parametri di connessione JDBC 
vengono reperiti da quanto precedentemente 
impostato. 

Al termine di ogni modifica, per renderle persi- 
stenti, salvare il progetto con "File > Save" e 
selezionare il percorso dove memorizzarlo. 
Sul CD-Rom è presente anche uno script per la 
creazione della base dati per MySql. 



UHI MUOVO PROGETTO 
ll\l ECLIPSE 

Le classi generate possono essere utilizzate e 
compilate sia usando i tool standard che utiliz- 
zando il proprio IDE preferito. Usando Eclipse 
si può creare un nuovo progetto; avendo 
installato il plug-in WTP si può creare un 



Dynamic Web Project specifico per il Tomcat 
installato. Non resta che copiare le classi gene- 
rate sotto la cartella src/ del progetto e i file 
XML generati (in particolare i file cayenne.xml, 
BlogMap.map.xml e CayenneloProgrammo 
Node.driver.xml) sotto la cartella /Web- 
Content/WEB-INF/classes/. Infatti, affinché 
un'applicazione possa utilizzare Cayenne, i file 
di configurazione devono stare sotto una car- 
tella che è o nel classpath o in un altro posto 
accessibile (al run-time) alle classi. Infine 
copiare il file cayenne.jar (si trova nella cartel- 
la lib/ dell'installazione del pacchetto) nella 
cartella /WebContent. Eseguendo un refresh 
su Eclipse il progetto includerà le nuove classi 
e, se tutto è stato configurato correttamente, le 
compilerà. 




o ■ Q ' % ' ùmm- * 




Fig. 1: II progetto di esemplo aperto con Eclipse 3.1. 



UTILIZZARE CAYENNE: 
DATACONTEXT 

L'oggetto fondamentale da conoscere, usando 
Cayenne, è il DataContext. Attraverso il 
DataContext si possono eseguire le interazioni 
con il database (leggere i dati, eliminare 
record, eseguire query e così via). Il 
DataContext deve leggere i file xml generati 
precedentemente dal tool grafico. Per farlo è 
necessario che i file siano accessibili dal clas- 
spath. Considerando che una webapp ha setta- 
to, di default, il classpath sulla cartella WEB- 
INF/classes, tale cartella è una buona candida- 
ta per copiare i file di configurazione. 
Una volta resi accessibili i file di configurazio- 
ne è necessario inizializzare il DataContext 
facendoglieli leggere. Una Webapp dovrebbe 
prevedere sempre una servlet di inizializzazio- 
ne (meglio se questa viene eseguita automati- 
camente allo start-up di tomcat) che la inizia- 
lizza in questo modo: 

public class initServIet extends HttpServIet { 
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//... 


public void init(ServletConfig 


conf) throws 
ServIetException { 


super.init(conf); 


BasicServletConfiguration.initializeConfiguration( 


conf.getServletContext() ); 


//■■■ 


} 


//■■■ 


} 



Nel progetto la servlet che effettua l'inizializza- 
zione è it.ioprogrammo.cayenne. servlet. 
InizializzaCayenne.java. Per come la abbiamo 
strutturata è leggermente più complessa 
rispetto alla sola inizializzazione del 
DataContext. Infatti va a leggere un file di pro- 
perties esterno da cui recupera il nome del file 
xml da caricare. Questo è utile in tutti quei 
contesti, comuni in progetti deployati su più 
sistemi, in cui diverse installazioni accedono a 
diverse basi di dati. 

Una volta inizializzato il DataContext (fatto 
una volta per tutte!) lo si può recuperare in una 
qualsiasi pagina jsp utilizzando la sessione 
(oggetto predefinito "session"): 



DataContext context 



BasicServletConfiguration.getDefaultContext( 



Tra i parametri ci può essere una qualunque 
oggetto derivato da GenericServletQuery. Uno 
degli oggetti senz'altro più utile è una query su 
una tabella; per indicare la tabella si può usare 
la classe; ecco, per esempio, come creare una 
query sulla tabella blog_entry: 

SelectQuery mySelectQuery = new 

SelectQuery(BlogEntry.class); 

Spesso è necessario indicare dei valori per uno 
o più campi. In questi casi la query può essere 
costruita come: 

new SelectQuery(BlogEntry.class, espressione); 

dove espressione è un oggetto di tipo 
Expression; esso può essere costruito a partire 
da una stringa: 

Expression esp = Expression. fromString( 

SELECT_STRING); 

dove SELECT_STRING può essere una qualun- 
que stringa del tipo "campo=valore" (per date 
e numeri) o "campo like 'valore' " per stringhe. 
Un modo per nominare i campi è quello di 
ricorrere ai nomi delle property generati in 
automatico da Cayenne; per esempio: 



LA PRIMA QUERY 

Lavorare con dati dinamici significa, essenzial- 
mente, reperirli da una base dati; l'operazione 
che permette di eseguire una query è: 



SELECT_STRING = 

BlogEntry.IN_HOME_PROPERTY+" like 'una 

stringa'"; 

Quando si vuole costruire stringhe di selezione 
con parametri variabili, si usa la notazione 
"$valore" per indicare dei segnaposto da sosti- 
tuire con valori opportuni; per esempio: 



List risultato = context. performQuery( .. ); 



DOWNLOAD E INSTALLAZIONE DI CAYENNE 



Collegandosi alla home page del 
framework, 

http://objectstyle.org/cayenne, si può 
seguire il link "Download" e quindi 
scegliere la versione (al momento 
della stesura dell'articolo la 
versione stabile è la 1.1.4). Scelto 
uno dei mirror viene eseguito il 
download del framework: esso si 
presenta in formato .tar.gz (TAR 
compresso); per scompattarlo si 
deve utilizzare o il comando Linux: 

tar -xzf nomefile. tar.gz 
Oppure, sotto Windows, si può 



utilizzare un tool come WinRar o 
WinZip. La cartella risultate ha la 
struttura mostrata in FIGURA. 



tì cayenne- 1.1.4 


Qbin 


E Q doc 


Q Qlib 


£3dvmodeler 


l'r^modeler 


§cayenne.jar 


§cayenne-nodeps.jar 


E Q src 



SELECT_STRING = 
BlogEntry.IN_HOME_PROPERTY+ " like $var" + 

BlogEntry.DATA_PROPERTY+" = $data"; 

per "istanziare" il segnaposto si può costruire 
un oggetto Map; su tale oggetto si assegnano 
coppie chiave/valore; i nomi della chiave 
vanno a sostituire i segnaposto omonimi; per 
esempio: 



Map p 


= nev\ 


i Map(); 


p.put( 


'var", 


'Sì"); 


p.put( 


'data", 


"2006/01/01"); 


esp = 


esp. ex 


pWithParameters( p ); 



equivale a scrivere: 



SELECT_STRING 



BlogEntry.IN_HOME_PROPERTY+ 
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" like 'Sì'" + 



ascending); 



BlogEntry.DATA_PROPERTY+ 



" = 2006/01/01"; 

Che accadese se, per esempio, non si assegnasse 
alcun valore a "data"? Semplicemente quella 
parte di espressione verrebbe ignorata! Si può 
costruire una espressione che contiene valori per 
ogni campo, dove sia i nomi dei campi sia quelli 
dei valori sono ricavati dai nomi delle proprietà: 



q ry. setFetch Li mit(num Record); 



qry.setPageSize(dimPagina); 

Infine si può assegnare un nome ad una query e 
far sì che il risultato della sua esecuzione sia 
mantenuto in cache: ogni sua "ri- esecuzione" 
non comporta una nuova query sul database, ma 
il reperimento dei dati dalla cache, a tutto van- 
taggio della performance! 




static final String SELECT_STRING 



BlogEntry.IN_HOME_PROPERTY+" like $" 



hBlogEntry.IN_HOME_PROPERTY+ 



" and db:id = $id and titolo like $titolo and " + 



BlogEntry.DATA_PROPERTY+" = $"+ 



BlogEntry.DATA_PROPERTY+" and " + 



BlogEntry.ABSTRACT_PROPERTY+ 



" like $" + BlogEntry.ABSTRACT_PROPERTY; 

Tale stringa può essere costruita una volta per 
tutte e dichiarata statica all'interno delle classi 
affinché non venga costruita ogni volta ("spre- 
cando" risorse nella costruzione di nuovi oggetti 
stringa). 

Un modo molto comodo per sostituire tutti i 
segnaposto è, per le applicazioni Web, ricavare 
un oggetto Map direttamente dai parametri della 
request e usare il metodo expWithParameters 
per sostituire tutti i segnaposto di una espressio- 
ne: 

Map params = request. getParameterMap(); 
esp = esp.expWithParameters( params ); 

Usando applicazioni Web, particolare attenzione 
va fatta, come sempre, per i tipi di dati che non 
sono stringhe: Integer (per essi basterà eseguire il 
parsing corretto) e le date (in questo caso va fatta 
attenzione alla possibilità che l'applicazione Web 
possa accettare date in diversi formati; per esem- 
pio GG/MM/AAAA per utenti italiani e 
MM/GG/AAAA per quelli americani e così via...). 
Per evitare che gli utenti siano costretti a scrivere 
le date in formato JDBC, nell'applicazione di 
esempio si è fatto uso di un "remapping" di tutte 
le date creando un'apposita funzione: 



INSERIRE NUOVI RECORD 

Per creare nuovi record della base dati si ricorre, 
ancora una volta, al DataContext di cui si invoca 
il metodo createAndRegisterNewObject sulla 
classe dell'oggetto da creare: 

BlogEntry ris = (BlogEntry) 
context.createAndRegisterl\lewObject( 
BlogEntry.class ); 



poi si assegnano i valori alle proprietà e si esegue 
l'inserimento vero e proprio invocando il meto- 
do: 

context.commitChangesQ; 



ELIMINARE/AGGIORNARE 
RECORD ESISTENTI 

Per eliminare un record è sufficiente eseguire il 
metodo deleteObject (sempre di DataContext) a 
cui si passa l'oggetto da eliminare. Per aggiorna- 
re un oggetto esso va reperito e vanno riassegna- 
te le sue proprietà; nell'articolo è stato creato un 
metodo (getOne) usato per reperire un BlogEntry 
dal suo codice: 

Object id = request. getParameter("id"); 
BlogEntry record = getOne(context, id); 
if (record! = null) { 

setFromRequest( record, request); 

context.commitChanges(); 
} 



Map params = Common. rema p( 



request. getParameterMap()); 

Su una query si può sia impostare un ordina- 
mento sui risultati (ascendente o descendente) 
sia limitare il numero di record restituiti che 
impostare una paginazione: 

qry.addOrdering( 
BlogEntry.DATA_PROPERTY, 



REPERIRE LA CHIAVE 
DI UN RECORD 

Osservando il codice sorgente precedente può 
sorgere un dubbio: come si fa a reperire l'identi- 
ficativo di chiave del record, se esso non appare 
tra le proprietà esposte dalla classe? In questo 
caso viene in aiuto un metodo della classe 
DataObjectUtils e precisamente il metodo stati - 
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co intPKForObject : 

int chiave = 



DataObjectUtils.intPKForObject( blog ); 



GESTIRE RECORD 
"DIPENDENTI 11 

Nel caso si vogliano aggiungere dei commenti ad 
un blog esistente, per prima cosa si deve reperire 
l'oggetto associato al record (usando, per esem- 
pio, una ricerca per chiave) e successivamente 
creare e aggiungere un oggetto di tipo Comment; 
per aggiungerlo si utilizzi il metodo 
AddToCommentArray: 

recordBlog.addToCommentArray( commento ); 



punti da modificare quando viene eliminato un 
campo da una tabella e viene rigenerato l'oggetto 
che esegue il mapping. Nelle form è sempre meglio 
inserire l'indicazione del numero massimo di 
caratteri accettati da un campi di input. Anziché 
scrivere i valori usare delle costanti; per esempio: 
BlogEntry.DESCRIZIONE_MAXCHARS. Queste 
vanno inserite negli oggetti creati da Cayenne (ma 
non in quelli il cui nome inizia con "_": questi 
vanno lasciati sempre inalterati!). 
Infine consiglio di creare sempre delle classi 
"manager" per la gestione delle usuali operazioni 
(select, insert, delete, ...) e che si occupano del 
mapping tra i parametri passati sulla request e le 
proprietà degli oggetti creati (o eliminati, reperiti e 
così via). 

Analizzando la webapp allegata all'articolo si 
noterà l'uso di tutti questi accorgimenti. 



Invece, per reperire tutti i commenti associati ad 
uno specifico blog: 

Comment[] commenti = blog.getCommentArray(); 



ESEGUIRE 

DEL CODICE SQL... 

Cayenne, a differenza di altri framework, lascia 
comunque libero il programmatore di eseguire 
comandi SQL di qualsiasi tipo. Infatti è sempre 
possibile usare oggetti di tipo SQLTemplate: 

SQLTemplate tempi = new SQLTemplate( 
(DataMap)dc.getDataMaps().iterator().next(), 

"SELECT descMta, descr FROM News, 

Autori WHERE Autori. id = news.id", 

true); 
tempi. setFetchingDataRows(true); 
List ris=dc.performQuery(templ); 

Gli oggetti restituiti da un simile comando (avendo 
impostato la proprietà FetchingDataRows a true) 
sono di tipo org.objectstyle.cayenne.DataRow. 



ALCUNI SUGGERIMENTI 

Con qualche accorgimento possiamo migliorare la 
qualità del codice sviluppato. Per prima cosa evitia- 
mo di scrivere i nomi dei campi come stringhe (per 
esempio come nomi di campi di una form che poi 
vengono letti e usati nelle select); questo per evita- 
re di disseminare errori del tipo "desrizione" anzi- 
ché "descrizione": molto meglio usare le costanti 
definite negli oggetti creati da Cayenne (per esem- 
pio BlogEntry.DESCRIZIONE_PROPERTY). Questa 
accortezza agevola anche l'individuazione dei 



CONCLUSIONI 

In Figura l'applicazione Web risultante. 
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Fig. 2: L'applicazione Web risultante 

Cayenne è un prodotto stabile, dalle ottime 
caratteristiche sia per ambienti di produzione 
che necessitano di prestazioni elevate sia per 
progetti semplici dove la facilità d'uso degli 
strumenti è una delle caratteristiche prepon- 
deranti. 

Da poco (marzo 2006) Cayenne è stato inseri- 
to tra i progetti di Apache; seguendo la solita 
trafila definita dall'associazione, inizialmente 
è considerato un progetto allo stato di incuba- 
zione (incubator). Dopo un periodo di prova, 
in cui dimostrerà se è capace di creare una 
nutrita comunità attorno al prodotto, in grado 
di garantire stabilità allo sviluppo del proget- 
to stesso, diventerà a tutti gli effetti uno dei 
progetti di Apache. Un motivo d'orgoglio per 
l'iniziatore del progetto e un'ulteriore garan- 
zia di stabilità e di una solida comunità per 
tutti gli utenti... 

Ivan Venuti 
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SCRIVILO SUL MURO 
CON SPRING MVC 

IMPARIAMO COME COSTRUIRE APPLICAZIONI PERFETTAMENTE MANUTENIBILI E CON 
UN ALTO GRADO DI DISACCOPPIAMENTO FRA CODICE E LAYOUT. REALIZZIAMO IL 
TUTTO CON UN ESEMPIO UTILE: UN GUESTBOOK CHE "SCRIVE SU UN MURO"... 
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000" 



Tempo di realizzazione 



Come abbiamo avuto già modo di 
apprendere nel numero 100 di 
ioProgrammo, Spring è un framework 
che viene utilizzato sia per facilitare l'utilizzo 
di altri framework sia per scrivere codice più 
pulito e manutenibile. Quest'ultima caratteri- 
stica è determinata dall'adozione di un pat- 
tern chiamato Inversion of Control che con- 
sente di comporre i vari moduli di un proget- 
to tramite un file XML. Per meglio compren- 
dere questo approccio alla programmazione 
analizziamo brevemente il seguente codice: 

public interface IA{ 

public void actionA(); 
} 



public interface IB{ 



public void actionBQ; 



public class B implements IB{ 



public void actionB(){ 



System. out.println("action B"); 



public class A implements IA{ 



protected IB b; 



public void setB(IB b){ 



this.b = b; 



public void actionA(){ 



System. out.println("action A"); 



this.b. actionBQ; 



public static void main(String [] ar){ 
ClassPathXmlApplicationContext f=new 
ClassPathXmlApplicationContext("factory.xml"); 



IA a = (IA)f.getBean("aa"); 



a.actionAQ; 



// file factory.xml 


<?xml version = "1.0" encoding = 


"UTF-8"?> 


<beans> 


<bean id = "bb" class="B"/> 


<bean id = "aa" class="A"> 


<property name="b" > 


<ref bean = "bb" /> 


</property> 


</bean> 


</beans> 



Abbiamo definito due interfacce e due classi 
che le implementano. La particolarità risiede 
però nell'implementazione del main presente 
nella classe A e nell' utilizzo del file factory.xml 
che determina i collegamenti tra le classi uti- 
lizzate. Infatti nel main viene definito un 
ApplicationContext dal quale è possibile otte- 
nere un'istanza dell'interfaccia IA, l'oggetto f 
definisce una factory di oggetti creati e com- 
posti secondo i dettami definiti nel file XML. 
In questo file è definito un tag <beans> che 
racchiude diversi tag <bean>; ogni tag <bean> 
definisce un oggetto istanza della classe defi- 
nita dall'attributo class. L'attributo id defini- 
sce il nome con cui l'oggetto può essere refe- 
renziato sia all'interno del file XML sia da 
codice Java. I tag property invece forzano il 
framework ad invocare il metodo setXXX 
identificato dall'attributo name, quindi al 
metodo setB viene passato l'oggetto che nel 
file XML è definto con id valorizzato a bb. 
Ricapitolando, il framework effettua per noi le 
seguenti operazioni: 



B bb = new B(); 



A aa = new A(); 



aa.setB(bb); 

Inoltre si può utilizzare l'ApplicationContext 
come una Hashtable e recuperare i vari ogget- 
ti usando come indice il valore dei vari attri- 
buti id presenti nei tag <bean>. Il primo van- 
taggio riscontrabile nell'utilizzo di questo fra- 
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mework è che se si utilizzano in modo appro- 
priato le interfacce si può cambiare il com- 
portamento di una classe solo con poche 
modifiche ad un file XML. 



LE BASI 

DI SPRING MVC 

Spring MVC è la soluzione offerta da questo 
formidabile framework per la realizzazione di 
applicazioni web. Adottando il "solito" pat- 
tern IoC, sono state sviluppate dai suoi pro- 
gettisiti delle API che, oltre a facilitare note- 
volmente l'approccio MVC, godono di un alto 
grado di apprendimento e di una flessibilità 
non riscontrabili in altri framework. Come al 
solito è prevista una particolare Servlet che 
funge da Dispatcher; ha quindi il compito di 
ricevere le richieste provenienti dal Browser e 
di smistarle al Controller previsto per quella 
determinata richiesta. Quindi il primo passo è 
quello di configurare il file di deploy web.xml 
per il mapping relativo alle richieste da pas- 
sare alla nostra Servlet. Esso conterrà i 
seguenti tag XML: 

<web-app> 
<servlet> 
<servlet-name>wall</servlet-name> 
<servlet-class>org.springframework. web. servlet. 
DispatcherServlet</servlet-class> 
</servlet> 
<servlet-mapping> 
<servlet-name>wall</servlet-name> 

< uri-pattern >*.jhtm</url-pattern> 
</servlet-mapping> 
</web-app> 

Così facendo abbiamo configurato la nostra 
webapp in modo che tutte le richieste aventi 
estensione .jhtm vengano passate alla Servlet 
istanza della classe DispatcherServlet; a tale 
Servlet inoltre viene associato il nome logico 
wall. Ciò è molto importante in quanto con- 
corre alla definizione del nome del file XML in 
cui risiedono le rimanenti configurazioni del- 
l'applicazione. Infatti nella stessa directory 
WEB -INF dobbiamo inserire il file wall-serv- 
let.xml che guida il framework nella definizio- 
ne delle dipendenze tra i vari oggetti. 



SPRINGWALL: 

UN ESEMPIO PRATICO 

Prepariamoci adesso alla realizzazione di un 
applicativo web con le funzionalità molto 



simili a quelle di un normale guestbook (libro 
degli ospiti). Ogni utente può scrivere un 
messaggio nel libro degli ospiti per manifesta- 
re la propria opinione; la particolarità che 
vogliamo dare a questa applicazione è di 
natura grafica, infatti i messaggi saranno 
visualizzati su un muro virtuale. Per la realiz- 
zazione di tali funzionalità la nostra applica- 
zione necessita di due Controller: uno per la 
visualizzazione dei messaggi ed uno per l'in- 
serimento dei messaggi tramite un form 
HTML. 

Ma come si implementa un Controller per il 
framework Spring MVC? 

Il framework propone diverse soluzioni per la 
realizzazione di un Controller, analizziamo la 
più semplice che è anche quella che utilizze- 
remo per la visualizzazione dei messaggi. 
Spring definisce la seguente interfaccia: 

public interface Controller{ 

public ModelAndView 

handleRequest(HttpServletRequest req, 
HttpServIetResponse res) throws Exception; 
} 

Quindi basta definire una classe che la imple- 
menti per ottenere oggetti funzionanti come 
Controller. Il metodo handleRequest restitui- 
sce un oggetto istanza della classe 
ModelAndView; come vedremo da qui a poco 
questi oggetti contengono informazioni ine- 
renti la view da utilizzare ed i dati (model) da 
inserire nella view stessa. 

public class WallController implements Controller{ 
protected WallMessageDAO dao = null; 
protected int maxMsg = 15; 

public ModelAndView 

handleRequest(HttpServletRequest req, 
HttpServIetResponse res) throws Exception { 
Hashtable model = new Hashtable(); 
ArrayList messages=this.dao.getMessages(); 
messages=this.tryCut(messages); 
model. put("messages",messages); 



COSA SERVE PER COMINCIARE 





I TUOI APPUNTI 



Per utilizzare Spring è necessario 
scaricare il framework presso il suo 
sito www.springframework.org. 
Una volta scaricato lo zip, bisogna 
scompattarlo in locale; sotto la 
directory dist sono presenti i jar di 
Spring che a secondo del contesto 
vanno copiati nel classpath 
dell'applicazione. Analogamente 



sotto la directory lib/velocity è 
presente il file velocity-1 .4.jar, 
anch'esso è da includere nel 
classpath della nostra applicazione. 
C'è da notare che sotto 
docs\reference\pdf è presente il 
file spring-reference.pdf che 
contiene un guida completa al 
framework. 
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return new 

Model And View(" wall",' 


model" 


, model); 


} 




public 


void setDao(WallMessageDAO dao) { 




this. 


dao = dao; 






} 




public 


void setMaxDim(int dim){ 








this. 


maxMsg = dim; 






} 


} 



La semantica della classe WallController è 
racchiusa tutta nel metodo handleRequest; 
per motivi di spazio non è stato utilizzato un 
layer di Business Logic. Quindi le operazioni 
inerenti la parte model del pattern MVC sono 
demandate al Controller stesso e ad un ogget- 
to istanza di WallMessageDAO che ha il com- 
pito di interagire con la base dei dati. Infatti 
vengono recuperati tutti i messaggi dal DB, 
successivamente, se la dimensione dei mes- 
saggi supera la dimensione massima stabilita, 
vengono scartati i più vecchi con il metodo 



VALIDARE I DATI 



Spring MVC prevede un meccanismo molto semplice e potente per la 
validazione dei dati provenienti da form HTML. Il framework definisce 
l'interfaccia Validator che espone due metodi supports e validate, per 
meglio comprendere il loro utilizzo analizziamo l'implementazione 
realizzata per la nostra applicazione. 

public class InsertValidator implements Validator{ 
public boolean supports(Class clazz) { 

return clazz. equals(WallMessageVO. class); 
} 

public void validate(Object obj, Errors errors) { 
Wa 1 1 Messa g eVO wmvo=(WallMessageVO)obj; 
if(wmvo.getMsg() = = null || wmvo.getMsg().trim().equals("")){ 
errors. rejectValue("msg", nuli, "Devi inserire un messaggio!"); 

} 

if(wmvo.getSender() = = null 1 1 wmvo.getSender().trim().equals("")){ 
errors. rejectValue("sender", nuli, "Devi inserire il tuo nome!"); 



} 

Il metodo supports può servire per identificare il contesto applicativo del 
Validator, nel nostro caso stiamo dicendo al framework che il nostro 
validator vuole trattare solo oggetti di tipo WallMessageVO. Il metodo 
validate invece stabilisce la modalità di validazione dei dati inviati. Il 
framework passa al validator un oggetto di tipo WallMessageVO e noi lo 
accettiamo, facciamo in modo che venga invocato il metodo onSubmit nel 
Controller associato, solo se i campi sender e msg non sono vuoti. In caso 
contrario viene utilizzato il metodo rejectValue presente nell'oggetto 
errors. Questo metodo pevede l'utilizzo di tre parametri, il primo 
definisce il nome del campo della form in cui visualizzare il messaggio di 
errore. Il secondo definisce il codice del messaggio di errore (per i nostri 
scopi non serve), mentre il terzo definisce il messaggio da visualizzare 
sulla form HTML (ne riparleremo quando studieremo la parte View). 



tryCut. A questo punto i dati che devono esse- 
re visualizzati dalla view vengono memorizza- 
ti in una Hashtable e successivamente vengo- 
no passati all'oggetto ModelAndView. 
Soffermiamoci su quest'ultimo passaggio per- 
ché merita un minimo di approfondimento: 
l'oggetto istanza di ModelAndView viene 
creato passando tre parametri nel costruttore; 
il primo identifica il nome della vista da utiliz- 
zare, il secondo invece il nome logico da uti- 
lizzare all'interno della vista per referenziare 
l'oggetto model (il terzo parametro) che con- 
tiene i dati che il Controller intende visualiz- 
zare. 



INIETTIAMO 



Diamo adesso un primo sguardo al file wall- 
servlet.xml. Come abbiamo già detto in prece- 
denza, in questo file sono definite le dipen- 
denze tra le varie entità che costituiscono il 
nostro progetto. In pratica Spring legge que- 
sto file ed in base alle "direttive" in esso con- 
tenute crea i vari oggetti e li lega tra di loro 
sfruttando i metodi setXXX che espongono. 

<beans> 

definizione di altri bean 



<bean id = "wallController" 

class="roby.spring wall. client. WallController"> 



<property name="dao" > 



<ref bean = "wmdao" /> 



</property> 



<property name="maxDim" > 



<value>15</value> 



</property> 



</bean> 



<bean id = "urlMapping" class= 
"org.springframework.web.servIet.handler.Simplell 

rlandlerMapping"> 
<property name="mappings"> 



<props> 


<prop 
key= 


"/wall.jhtm">wallController</prop> 


<prop 

key 


= "/insert.j htm' 


>insertForm</prop> 


</props> 


</property> 


</bean> 


definizione 


di altri bean 




</beans> 



Il bean con id urlMapping serve a definire la 
strategia con cui il framework associa le 
richieste ai vari Controller. Nel nostro caso 
utilizziamo un SimpleUrlHandlerMapping 
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che effettua un'associazione in base alla URL 
della richiesta. Alla URL che termina con 
/wall.jhtm associa il Controller identificato 
dal bean avente id valorizzato a 
wallController, mentre quello (non riportato 
nel precedente listato) con id valorizzato a 
insertForm si occuperà delle richieste che 
puntano a /insert.jhtm. Osservando il bean 
relativo a wallController ci accorgiamo che il 
framework effettua l'invocazione dei metodi 
setDao e setMaxDim, passando al primo il 
riferimento del bean wmdao e al secondo l'in- 
tero 15. 



IL DATA LAYER 

La nostra applicazione utilizza un semplice 



ArrayList res=null,list=null; 





B wallmessage : Table 


U[n](xJ 




Field Nanne 


Data Type 


a| 


? 


id 


AutoNurmber 


il 




msg 


Memo 


Irr 


sender 


Text 




datet 


Date/Tirne _^J 


J 



Fig. 1: Struttura della tabella che memorizza 

I messaggi 

DataBase formato da una sola tabella Access 
avente la seguente struttura. 

II campo id è di tipo autonumber ed è la chia- 
ve primaria, msg memorizza i messaggi 
postati dagli utenti, sender invece memorizza 
l'autore del messaggio ed infine il campo 
datet serve a tenere traccia della data in cui è 
stato scritto il messaggio. Per il mapping della 
tabella utilizziamo il seguente Value Object: 



public class Wa 1 1 Messa g eVO { 


protected int id = -l; 


protected String msg = null; 


protected String sender=null; 


protected GregorianCalendar date=null; 


... metodi get e set relativi alle 


... precedenti variabili 


} 



Per quanto riguarda l'interazione con il DB 
implementiamo un oggetto WallMessageDAO 
che espone i metodi per la gestione dei dati. 

public class WallMessageDAO { 

protected JdbcTemplate jdbcTemplate=null; 
public void setJdbcTemplate(JdbcTemplate 

JdbcTemplate) { 
this.jdbcTemplate = JdbcTemplate; 

} 

public ArrayList getMessages(){ 



List li=this.jdbcTemplate.queryForList("select 
from wallmessage order by id desc"); 



list= new ArrayList(li); 



Map map = null; 



WallMessageVO p = null; 




res=new ArrayListQ; 



for(int i = 0;i<list.size();i + + ){ 



map=(Map)list.get(i); 



p=new WallMessageVOQ; 



p.setId(((Integer)map.get("id")).intValue()); 



VELOCITY 



Riprendiamo molto velocemente 
quanto visto nel numero 100 di 
ioProgrammo in cui abbiamo 
approfondito la conoscenza di 
questo splendido framework grazie 
all'articolo dell'ottimo Luigi 
Caputo. Velocity, progetto 
realizzato dalla Apache Foundation 
Group, è un template engine 
implementato interamente in 
Java; per template engine si 
intende una collezione di API che 
permette la generazione dinamica 
di contenuti testuali formattati 
secondo specifici modelli 
(template). In ambito web è 
possibile combinare insieme 
codice html/java script con codice 
VTL. Il VTL è il linguaggio di 
scripting usato da Velocity, per 
scelta è molto semplice in quanto 
deve forzare chi lo utilizza ad 
effettuare le elaborazioni più 



complesse negli altri layer 
(probabilmente nella parte Model) 
dell'applicazione. 
Gli elementi principali del 
linguaggio VTL sono i reference e le 
direttive; i primi sono preceduti del 
carattere '$', mentre le direttive 
sono introdotte dal carattere '#' 
Ci sono tre tipi di reference: le 
variabili, le proprietà ed i metodi. 
Le variabili possono essere 
importate da codice Java oppure 
possono essere introdotte 
direttamente nel template; per 
effettuare quest'ultima operazione 
è necessario l'utilizzo della 
direttiva #set($v=<valore>). 
Altre direttive degne di nota sono 
la direttiva di selezione 
#if(<condizione>) ... #else .... #end 
e la direttiva di loop 
#foreach($item in Scollection) ... 
#end 



inserimento altri campi 



res.add(p); 



} 



return res; 



} 



public void deleteLess(int id){ 



String dele="delete from wallmessagewhere 

id< = " + id; 



this.jdbcTemplate. update(dele); 



} 



public void insert(WallMessageVO wm){ 



String ins="insert into 



wallmessage(msg,sender,datet) values("; 

ins+ = '""+wm.getMsg( ) + "','" + 

wm.getSender() + "','" 

+wm.getFormattedDate() + "')"; 

this.jdbcTemplate. update(ins); 



} 



Il metodo insert serve ad inserire un nuovo mes- 
saggio nel DB, mentre il metodo getMessages 
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CONTROLLER 
E VARIABILI 
DI ISTANZA 

Nel l'implementare i 

Controller con Sprìng 

MVC bisogna rispettare 

alcune regole di buona 

programmazione; 

infatti, così come 

avviene per le Servlet, 

il framework istanzia 

un solo Controller 

(uno per ogni classe 

che implementa 

l'interfaccia 

Controller), quindi se si 

usano variabili (o 

oggetti) istanze di 

Classe si corre il rischio 

che diverse richieste 

http accedano 

contemporaneamente, 

e quindi in regime di 

concorrenza, a tali 

variabili. 



J J Oggetti Java 



Applicazione Java 



( ModelAndView 




File .vm (template) 



Documento formattato 



Fig. 2: Velocity combina la potenza di Java 
alla vetsilità dei template testuali 

serve a recuperare tutti i messaggi dal DB; infine 
deleteLess serve ad eliminare i messaggi più vec- 
chi. E' importante notare come nel precedente 
codice non compaia nessun oggetto delle API 
JDBC. Infatti abbiamo voluto utilizzare la classe 
JdbcTemplate, questa facilita e riduce di molto il 
lavoro degli sviluppatori effettuando un wrap- 
ping delle principali funzionalità messe a dispo- 
sizione dal package java.sql. Il metodo update 
consente di effettuare query di DELETE, INSERT 
ed UPDATE, mentre queryForList è utilizzabile 
per query di tipo SELECT in cui i risultati vengo- 
no restituiti in una java.util.List. Come possiamo 
notare in quest'ultimo caso non si ricorre all'uti- 
lizzo di un ResultSet, infatti queryForList restitui- 
sce una List di oggetti di tipo java.util.Map. Come 
per ResultSet ogni entry della tupla corrente può 
essere referenziata dal nome della colonna della 
tabella. Come al solito non ci resta che iniettare 
le dipendenze ricorrendo al file wall-servlet.xml. 

<bean id = "ds" class= 

"org.springframework.jdbc.datasource.DriverMana 

gè DataSource"> 
<property name="driverClassName" > 
<value>sun.jdbc.odbc.JdbcOdbcDriver</value> 
</property> 

<property name="url" > 
<value>jdbc:odbc:WallMessage</value> 
</property> 
</bean> 

<bean id = "jt"class="org. 
springframework.jdbc.coreJdbcTemplate> 
<property name="dataSource" > 

<ref bean = "ds" /> 
</property> 
</bean> 
<bean id = "wmdao" 

class="roby.springwall.dao.WallMessageDAO"> 
<property name= "JdbcTemplate" > 

<ref bean = "jt" /> 
</property> 
</bean> 



Abbiamo visto in precedenza che il bean wmdao 
serve al WallController per interagire con il DB, a 



sua volta esso necessita di un oggetto istanza di 
JdbcTemplate che è definito dal bean avente id 
valorizzato a jt. Quest'ultimo utilizza un oggetto 
DriverManagerDataSource per connettersi al 
Data Base. Questa operazione viene effettuata 
per mezzo dei parametri driverClassName e uri 
che identificano rispettivamente il driver JDBC 
utilizzato e l'URL di connessione. 



INSERIAMO I DATI 

E' giunto il momento di fornire al nostro siste- 
ma un modo per inserire i messaggi; a tal fine 
utilizzeremo un Controller un po' particolare. 
Infatti, così come avviene per altri framework, 
Spring MVC prevede un trattamento partico- 
lare per la gestione dei Form HTML. Come al 
solito noi utilizzeremo solo alcune delle API 
messe a disposizione dal framework; in parti- 
colare utilizzeremo un Validator per la valida- 
zione dei dati ed un Controller che lo utilizza. 

public class InsertController extends 

SimpleFormController { 
protected WallMessageDAO dao=null; 
protected ModelAndView onSubmit(Objectobj){ 
WallMessageVO wmvo = (WallMessageVO)obj; 
Hashtable model = new Hashtable(); 
wmvo.setDate(new GregorianCalendar()); 
this.dao.insert(wmvo); 
model. put("msg",wmvo); 
return newModelAndView 

(this.getSuccessView(), "model", model); 

} 

public void setDao(WallMessageDAO dao) { 
this.dao = dao; 



} 



La prima cosa che possiamo notare è che questo 
Controller, contrariamente a quello visto in prece- 
denza, non implementa direttamente l'interfaccia 
Controller ma lo fa indirettamente estendendo la 
classe SimpleFormController. Questa classe preve- 
de diversi metodi onSubmit, nel nostro caso utiliz- 
ziamo quello più adatto alle nostre esigue esigenze. 
Esso prevede l'utilizzo di un solo parametro che 
corrisponde all'oggetto che mappa i campi del 
Form HTML, tutto ciò ci viene "regalato" dal fra- 
mework senza accedere direttamente ai parametri 
della richiesta http. Una volta ottenuto l'oggetto 
istanza della classe WallMessageVO, lo completia- 
mo inserendo la data e successivamente inseriamo 
il nuovo oggetto sul DB. A questo punto non ci resta 
che restituire un oggetto ModelAndView opportu- 
namente creato. Come possiamo notare il nome 
della vista da utilizzare (il primo parametro passa- 
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to nel costruttore) lo ricaviamo attraverso il meto- 
do getSuccessView, esso utilizza un parametro 
definito nel file wall-servlet.xml. Infatti non dob- 
biamo mai dimenticare che con Spring il compor- 
tamento degli oggetti definiti tramite codice Java 
dipende fortemente da quanto stabilito nei file di 
configurazione. 

<bean id = "insertValidator" 

class="roby.spring wall. client. InsertValidator"/> 
<bean id = "insertForm" 

class="roby.springwall.client.InsertController"> 
<property name="dao" xref bean = "wmdao" 

/></property> 
<property 

name="commandName"><value>wmsg</value> 

<property> 
<property name="commandClass"> 

<value>roby.springwall.vo.WallMessageVO 

</value> 
</property> 
<property name="validator"> 
<ref bean = "insertValidator"/x/property> 
<property 

name="formView"><value>insert</value> 

</property> 
<property 
name="successView"xvalue>okInsert</value> 

</property> 
</bean> 

Analizzando questo frammento del file wall-serv- 
let.xml ci accorgiamo che la costruzione del 
Controller in questione è leggermente più compli- 
cata di quella vista in precedenza. Finalmente pos- 
siamo constatare che la vista utilizzata in caso di 
successo è quella definita dalla property avente 
name valorizzato a successView; anche in questo 
caso il framework inserisce tramite il metodo 
setDao l'oggetto istanza di WallMessageDAO e 
definito nel bean avente come id il valore wmdao. 
La property formView specifica il link al Form 
HTML utilizzata per l'inserimento dei dati. Le pro- 
perty commandName e commandClass concorro- 
no alla definizione dell'oggetto che effettua il bin- 
ding dei valori inseriti dall'utente: il primo specifi- 
ca il nome logico utilizzato nella vista (lo capiremo 
meglio da qui a poco), mentre il secondo definisce 
il nome della classe da utilizzare per istanziare il 
precedente oggetto. La property validator serve a 
definire il Validator da utilizzare per la validazione 
della form. 



VIEW CON VELOCITY 

Finora ci siamo occupati dei Controller e della 
gestione dei dati, per quanto riguarda la loro rap- 



presentazione sul web ci siamo solo limitati a 
sottolineare che i Controller, una volta elaborati i 
dati, ne estraggono un modello (Model) che li 
rappresenta e lo affidano alla parte View dell'ap- 
plicazione. Uno dei punti di forza di Spring MVC 
deriva proprio da questo comportamento, infatti 
finora non abbiamo fatto nessuna supposizione 



4 nche a me ...è davvero eccezionale? 
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Sputigmica di pingopalìo :-) 



iao programmatori vi piace Spring 
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Fig. 3: 1 messagi scritti sul muro 

sulla tecologia da utilizzare nella nostra applica- 
zione. Questa netta separazione tra i vari layer 
consente di scegliere la tecnologia che più ci 
piace; per la realizzazione del nostro muro utiliz- 
zeremo Velocity, è utile sottolineare però che, 
senza cambiare una solo riga di codice Java, 
avremmo potuto optare per le JSP.E' ovvio che 
tale scelta influisce solo sulla definizione del file 
wall-servlet.xml. 

<bean id="velocityConfig" class= 

"org.springframework. web. servlet. view. velocity. 
VelocityConfigurer"> 
< property name="resourcel_oaderPath"> 

<valuex/value> 
</property> 
</bean> 

Questo bean serve per l'inizializzazione di 
Velocity. Infatti tramite la property 
resourceLoaderPath si stabilisce il root path in 
cui andare a cercare i file .vm che rappresentano 
i template Velocity. Quella che abbiamo appena 
visto è una configurazione specifica di Velocity 
che nel caso delle JSP non va utilizzata, invece 
quello di cui necessita in tutti i casi una webapp 
sviluppata con Spring MVC è la definizione di un 
bean con id valorizzato a viewResolver. 

<bean id="viewResolver" class= 

"org.springframework. web. servlet. view. velocity. 
Velocity ViewResolver" > 
<property name="prefix"> 
<value>/WEB-INF/vm/</valuex/property> 
< property name="suffix"xvalue>.vm</value> 
</property> 




SETTERS O 
COSTRUTTORI? 

Spring supporta due 
modi per effettuare la 
Dependency Injection 
(o Inversion of Control) 
tra gli oggetti di 
un 'applicazione: 
isetter-based: è la 
modalità in cui i bean 
sono legati tra di loro 
uti /zzando i metodi 
set<Proprieta>. 
Questa modalità è 
quella utilizzata in 
questo articolo e 
suggerita nella 
documentazione 
stessa, 
iconstructor-based: è la 
modalità in cui i bean 
sono legati tra di loro 
sfruttando il 
passaggio degli 
oggetti nei 
costruttori 
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<propert 
name="exposeSpnngMacroHelpers"><value>true< 

/valuex/property> 
</bean> 

Il framework cerca nel file XML un bean avente que- 
sta caratteristica e grazie ad esso capisce quale tee- 



LA CONFIGURAZIONE DEL DB 



Questo progetto utilizza come 

database un DB Access 

memorizzato nel file 

wallmessage.mdb presente nel 

ed nella sottodirectory 

WEBJNF della webapp. Per 

configurare il database Access 

è necessario: 

i Eseguire Data Sources (ODBC) 
presente in Settings/Control 
Panel/ Administrative Tools 



i Scegliere User DSIM/Add, 
selezionare Microsoft Access 
Driver(*.mdb) e poi il 
pulsante Finish 
In Data Source Name inserire 
la stringa WallMessage 
Nel riquadro Database, con il 
pulsante Select... selezionare 
il file .mdb in cui risiede il DB 

i Confermare con OK nelle due 
form aperte 



nologia utilizzare per il rendering delle view. Nel 
nostro caso stiamo definendo un prefisso ed un suf- 
fisso per l'identificazione della view; per esempio 




Roberto Sidoti è 

ingegnere informatico, 

attaulmente si occupa 

di servizi VolP basati 

sul protocollo SIP 

presso Telecom Italia 

LAB come consulente 

esterno. I suoi 

maggiori interessi 

riguardano le 

applicazioni distribuite 

sviluppate con 

tecnologia J2EE, da 

marzo 2005 si occupa 

dello sviluppo e della 

gestione del progetto 

GeiNuke 

(www.hostingja va. itl- 

geinukel). 



Fig. 4: 1 messagi di errore notificati dal Validator 

nel WallMessageController abbiamo visto che l'og- 
getto ModelAndView veniva costruito con il para- 
metro relativo alla view valorizzato con la stringa 
"wall". In realtà quel valore composto con il prefisso 
ed il suffisso identifica la vista contenuta nel file: 
<webapp>/WEB-INF/vm/wall.vm 
La parte saliente di questo file è riassunto nel 
seguente codice: 



<table ... backg 


rou 


nd = "images/brick.jpg' 


> 


#foreach($nr 


in 


$model.messages) 




<trxtd> 


$m 


.formattedDate </tdx/tr> 


<trxtd> 


$m 


.msg </tdx/tr> 




<trxtd> 


$m 


.sender </tdx/tr> 




#end 


</table> 



La direttiva #foreach ci consente di scorrere tutti 
gli elementi $m contenuti in $model.messages, 



ognuno di questi elementi rappresenta una 
istanza della classe WallMessageVO e quindi tra- 
mite i campi formattedDate, msg e sender riu- 
sciamo a visulaizzare le informazioni che contie- 
ne. Vediamo adesso di analizzare la parte più 
importante della vista insert.vm: 

<form method = "POST" action=""> 

<table width="90%" border="0" cellspacing="0" 

cellpadding="0"> 
<trxtd> 
#springBind("wmsg. sender") 

$status.errorMessage <br/> 
autore <input type="text" name="sender" 

value="$!status.value"> 
</tdx/trxtrxtd> 
#springBind("wmsg.msg") 

$status.errorMessage<br/> 
messaggio<br/> <textarea name="msg" 
rows="8" cols="40">$!status.value</textarea> 
</td > </trxtr> <td > 
<input type="submit" value="Invia" 

name="submit7> 

</tdx/tr> 

</table> 
</form> 

Poco prima del primo tag input notiamo il seguen- 
te codice VTL: #springBind("wmsg.sender") Ssta- 
tus. errorMessage 

La prima è una direttiva che serve a dichiarare al 
framework che il successivo input (di tipo text) 
serve a valorizzare il campo sender dell'oggetto 
wmsg, la scelta del nome dell'oggetto ed il tipo 
sono fissati nel file xml dalle property 
commandName e commandClass del bean avente 
id valorizzato a InsertController. La successiva 
espressione VTL $status.errorMessage gioca un 
ruolo attivo in caso di mancata compilazione del- 
l'input in questione; infatti, come avevamo già 
visto nella classe InsertValidator, esso determina la 
visualizzazione del messaggio di errore "Devi inse- 
rire il tuo nome!". Un comportamento del tutto 
simile viene assunto dal succesivo tag <textarea>. 



CONCLUSIONI 

In questo articolo abbiamo visto ed apprezzato le 
caratteristiche principali di Spring MVC, abbia- 
mo imparato ad utilizzarlo insieme a Velo city 
sottolinenado che il codice scritto non preclude 
l'utilizzo di altre tecnologie come le JSP. A questo 
punto non ci resta che approfondirne la cono- 
scenza restando sempre sintonizzati con il fra- 
mework Spring che sta deliziando sempre più il 
mondo degli sviluppatori Java. 

Roberto Sidoti 
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CREARE L'HELP 

DI UN'APPLICAZIONE 



IL FRAMEWORK .NET FORNISCE LE CLASSI NECESSARIE AD IMPLEMENTARE SISTEMI DI HELP 
ON-LINE PER LE APPLICAZIONI WINDOWS FORMS. ECCO COME UTILIZZARLE PER DOTARE 
OGNI APPLICAZIONE DEL SUPPORTO CHE GLI UTENTI SI ASPETTANO 




n 




i_i li ii'i ^m 

7 Conoscenze base di C# 



\ Visual Studio 2005 
I oppure Visual C# 
Express Edition 




Scrivere la documentazione ed i file di 
help di un'applicazione è spesso un 
compito sottovalutato, o addirittura tra- 
lasciato. Magari perché ritenuto meno nobile 
dello sviluppo, oppure perché noi sviluppato- 
ri crediamo di non poter togliere tempo alla 
programmazione vera e propria. 
Ma chi dovrebbe scrivere il manuale e la 
guida, se non coloro i quali hanno creato l'ap- 
plicazione? Affidarla a terzi rallenterebbe o 
peggiorerebbe il processo; dato che prima 
questi dovrebbero acquisire conoscenza 
approfondita dell'applicazione, probabilmen- 
te, facendo perdere tempo prezioso allo svilup- 
patore, a causa di continue interruzioni per 
maggiori informazioni sul funzionamento. 
Senza un sistema di Help, o di un manuale 
decente, la vostra applicazione, che magari è 
ottima, probabilmente la migliore nello svol- 
gere il suo compito, potrebbe risultare inuti- 
lizzabile per l'utente medio, abbassando così 
di molto il suo valore, ed il suo appeal per gli 
utenti, che magari preferiranno pagare un 
altro tool, pur di avere un help a cui rivolgersi 
quando non sanno come utilizzare una fun- 
zionalità più avanzata, un pulsante, un menu 
mai visto. 



TECNICHE DI AIUTO 

Esistono diverse tecniche per aggiungere una 
funzionalità di help ad un'applicazione. La 
maggior parte sono ormai diventate uno stan- 
dard de facto sia nel mondo Windows sia 
Unix. 

Ad esempio, praticamente, ogni applicazione 
ha un menu Help, spesso abbreviato con un 
punto interrogativo, oppure in ognuna il tasto 
FI attiva un help contestuale sulla funzione 
che si sta utilizzando, ed ancora molte utiliz- 
zano dei fumetti o tooltip, che appaiono posi- 
zionando il mouse su un controllo, e spiegan- 
do la sua funzione. 



Tutti sono sistemi semplici da implementare 
anche nel mondo delle applicazioni .NET, il 
cui framework fornisce le classi necessarie per 
realizzarle. 

In questo articolo creeremo dunque una sem- 
plice applicazione, e vedremo come aggiun- 
gere le varie modalità di aiuto in linea. 



L'APPLICAZIONE 
SENZA HELP 

Creiamo intanto una semplice applicazione 
Windows costituita da una singola finestra, e 
da qualche controllo, come pulsanti, textbox e 
così via. 

Dato che lo scopo dell'articolo non è quello di 
mostrare la creazione di un'applicazione 
mostriamo solo l'interfaccia che utilizzeremo 
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Fig.l: Un'applicazione a cui aggiungere l'help 

nel prosieguo, rinviando al codice allegato nel 
CD o sul sito Web di ioProgrammo per chi non 
volesse crearla in modo autonomo. 
La nostra applicazione si compone semplice- 
mente di una Form per inserire i dati perso- 
nali, ad esempio per una rubrica, o per un 
sistema di gestione clienti. Inizialmente l'ap- 
plicazione non avrà alcun sistema che aiuti 
l'utente a capire come inserire i dati, oppure 
che lo avverta se i dati inseriti non sono validi, 
pensiamo ad esempio al CAP, che deve rispet- 
tare un certo formato numerico. 
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TOOLTIP E STATUSBAR 

Supponiamo che la la nostra forni possieda 
un pulsante con l'etichetta Carica, ma a che 
serve? Utilizzando un tooltip quando si posi- 
ziona il puntatore del mouse su di esso pos- 
siamo far apparire una descrizione od una 
spiegazione. 

Con Visual Studio è sufficiente trascinare 
dalla casella dei controlli il componente 
ToolTip sulla Form per fare in modo che ogni 
controllo sia dotato di una nuova proprietà, 
Tooltip on Nometooltip. 

Impostando una stringa essa sarà utilizzata 
come tooltip per il controllo. La stessa cosa si 
può ottenere naturalmente via codice. 
Per creare un'istanza del ToolTip è necessario 
invocare il costruttore di default, e poi utiliz- 
zare il metodo SetTooltip specificando il con- 
trollo e la stringa da mostrare. 

ToolTip mioTooltip = new ToolTip(); 
mioTooltip.SetToolTip(btCarica, "Carica la foto di 

questo cliente"); 
mioTooltip. SetToolTip(btClose, "Chiudi la 

finestra"); 

Una sola istanza di ToolTip può dunque esse- 
re utilizzata con tutti i controlli presenti sulla 
forni. 

La figura 2 mostra il tooltip che appare posi- 
zionando il puntatore del mouse sul pulsante 
Carica. 



sender,MouseEventArgs e) 




Fig.2: Tooltip per un pulsante 

Un altro sistema per mostrare informazioni su 
ciò che sta accadendo su una finestra dell'ap- 
plicazione, è quello di mostrare una stringa 
sulla barra di stato, che varia ad esempio spo- 
stando il focus da un controllo all'altro, 
mostrando dunque in tempo reale una descri- 
zione dell'informazione data dal controllo. 
Per realizzare questo effetto, dopo aver 
aggiunto un controllo StatusStrip, e creata 
una ToolStripStatusLabel al suo interno, sarà 
necessario gestire l'evento MouseMove dei 
controlli interessati e dell'intera Form, impo- 
stando la proprietà Text della ToolStrip 
StatusLabel, ad esempio così: 

private void txtIndirizzo_MouseMove(object 



this.toolStripStatusLabel.Text = 

"L'indirizzo del cliente"; 



} 



private void txtCittà_MouseMove(object sender, 

MouseEventArgs e) 




{ 



this.toolStripStatusLabel.Text = 

"La città di residenza del cliente"; 



} 



private void cboCAP_MouseMove(object sender, 

MouseEventArgs e) 



{ 



this.toolStripStatusLabel.Text = "Il CAP 
di residenza del cliente"; 




} 



private void Forml_MouseMove(object sender, 

MouseEventArgs e) 



{ 



this.toolStripStatusLabel.Text 



} 



Notate come nel caso dell'evento MouseMove 
relativo all'intera Form, resettiamo il conte- 
nuto con una stringa vuota. 



LA CLASSE 
ERRORPROVIDER 

La classe ErrorProvider permette di dare all'u- 
tente dell'applicazione un feedback su deter- 
minate situazioni di errore. Classicamente 
essa viene utilizzata quando dei controlli da 
valorizzare vengono riempiti con valori non 
validi. Pensate ad esempio ad una TextBox che 
deve contenere solo numeri, oppure che deve 
essere validata secondo certi criteri, come 
numeri solo positivi, o stringhe in un certo 
formato. Mediante i metodi della classe 
ErrorProvider, è possibile mostrare all'utente 
un'icona al lato di un determinato controllo 
che non è stato valorizzato correttamente. 
Supponiamo ad esempio che il nome del 
cliente sia un campo obbligatorio. Quando sia 
valida la Form, per esempio chiudendola, è 
possibile verificare la presenza del nome del 



I COMPONENTI PROVIDER 



I TUOI APPUNTI 



Esistono dei componenti forniti dal 
.NET Framework, che pur non 
essendo visibili all'utente 
permettono di dotare i controlli 
grafici di nuove proprietà. Tali 
componenti sono detti appunto 



extender provider, e comprendono 
i tre visti nell'articolo: Tooltip, 
ErrorProvider ed HelpProvider. Gli 
sviluppatori possono creare il 
proprio provider implementando 
l'interfaccia lExtenderProvider. 
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cliente e se il campo è vuoto mostrare un'ico- 
na di errore: 

private void btClose_Click(object sender, 

EventArgse) 

S 

if (txtNome.Text == String.Empty) 

{ 

ErrorProvider error = new 

ErrorProvider(this); 
error.SetError(txtl\lome, "Inserire il nome"); 



L'icona mostra un punto esclamativo, per 
default sulla destra del controllo interessato, 
che lampeggia un determinato numero di 
volte, e che mostra un ToolTip posizionandovi 
sopra il puntatore, come mostrato in figura 3. 



B Form! 



Norme 



Indirizzo 



* 



Cognome 



Città 



llnserire il nome k — 

1 ' 



CAP 



Fig.3: L'icona di errore associata ad una TextBox 

È possibile configurare diversi aspetti 
dell' ErrorProvider, per mezzo di proprietà e 
metodi. 

Impostando la proprietà BlinkRate è possibile 
variare la velocità di lampeggio dell'icona di 
errore, data in millisecondi, e che per default 
è di 250 millisecondi. Se invece, ad esempio, 
vogliamo che l'icona lampeggi ad intervalli di 
1 secondo, sarà sufficiente impostare il valore 
di BlinkRate alOOO: 

error. BlinkRate= 1000; 

La proprietà BlinkStyle invece permette di 
definire quando l'icona deve lampeggiare, 
usando uno dei valori dell'enumerazione 
ErrorBlinkStyle. Per default il blink è sempre 
attivo, quindi impostata a AlwaysBlink, e 
quindi esso si verifica ad ogni occorrenza dei- 
Terrore. 

Se invece si desidera che l'icona rimanga 
fissa, si può usare il valore NeverBlink, o anco- 
ra se il lampeggio deve verificarsi solo su erro- 
ri diversi da eventuali errori precedenti sullo 
stesso controllo, bisogna utilizzare il valore 
BlinklfDifferentError. 

error.BlinkStyle = ErrorBlinkStyle. NeverBlink; 

È possibile anche configurare il posiziona- 



mento dell'icona stessa oppure un'icona per- 
sonalizzata al posto del punto esclamativo. 
Il metodo SetlconAlignment imposta l'alli- 
neamento dell'icona rispetto al controllo 
associato, utilizzando uno dei valori dell'enu- 
merazione ErrorlconAlignment. Ad esempio 
se si vuol posizionare l'icona alla sinistra della 
TextBox, ed allineata al centro di essa scrive- 
remo: 

error. SetIconAlignment(txtNome, 

ErrorlconAlignment. MiddleLeft); 

La distanza dal controllo è invece controllata 
mediante il metodo SetlconPadding, con cui è 
possibile specificare il numero di pixel da uti- 
lizzare per il distanziamento: 

error.SetIconPadding(txtl\lome, 1); //l solo pixel 

di padding 

Per utilizzare un'icona personalizzata invece, 
basta impostare la proprietà Icon, creandone 
ad esempio una da un file con estensione ico, 
così: 

error. Icon = new Icon("erroricon.ico"); 

Ciò senza dubbio darà un aspetto personale 
alla vostra applicazione, come ad esempio 
quella in figura 4. 




Fig.4: Un'icona di errore personalizzata 



LA CLASSE 
HELPPROVIDER 

L'help contestuale consente di fornire all'u- 
tente aiuto ed informazioni su un particolare 
controllo, semplicemente selezionandolo e 
utilizzando i tasti di scorciatoia opportuni. 
Per far ciò, è possibile in .NET utilizzare la 
classe HelpProvider. Una volta aggiunto un 
componente HelpProvider, tramite la casella 
degli strumenti di Visual Studio oppure via 
codice, sarà possibile impostare la stringa di 
help per ogni controllo che si vuole, ad esem- 
pio, per la TextBox txtNome scriveremo: 
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HelpProvider helpProvider = new HelpProvider(); 
helpProvider.SetHelpString(txtl\lome, "Il nome del 

cliente"); 
helpProvider.SetHelpString(btCarica, "Carica un 

file immagine che rappresenta la foto del 

cliente"); 
helpProvider.SetHelpString(btClose, "Chiude la 

finestra"); 

Cliccando sulFHelpButton della Form, il pun- 
tatore visualizzerà un punto interrogativo, ed 
a questo punto ogni controllo per cui è stata 
impostata una stringa di Help visualizzerà al 
click su di esso tale stringa in una sorta di 
tooltip, come mostrato in figura 5. 




Carica un file immagine che 
rappresenta la foto del cliente 




Fig.5: Help contestuale del pulsante 

La stessa cosa avverrà, senza alcuna aggiunta 
di codice, cliccando il tasto FI dopo aver 
impostato il focus su un controllo. 
Per visualizzare un pulsante di Help sulla fine- 
stra, innanzitutto è necessario impostare a 
true la proprietà HelpButton della nostra 
Form, e quindi impostare a false le proprietà 
MaximizeBox e MinimizeBox. 
Ciò visualizzerà sulla barra del titolo della 
finestra un pulsante con un punto interrogati- 
vo, che una volta cliccato attiverà l'help con- 
testuale, situazione verificabile dal fatto che 
anche il puntatore del mouse cambierà 
Se avete utilizzato Visual Studio per aggiunge- 
re il controllo HelpProvider, ogni controllo 
sarà dotato di una nuova proprietà HelpString 
on NomeHelpProvider nella finestra delle 
proprietà, da impostare con la stringa di Help 
per il controllo stesso. 



UTILIZZARE UN FILE 
DI HELP 

Sempre tramite la classe HelpProvider è pos- 



sibile aprire un file di help esterno, sia esso un 
file html, che un file ehm, cioè il classico file 
di help HTML compilato, con sommario, indi- 
ce, ricerca. 

Per impostare il file HTML da aprire, basta 
impostare la proprietà HelpNamespace utiliz- 
zando il percorso del file, ed invocare il meto- 
do SetShowHelp per indicare che Fhelp è atti- 
vo su un determinato controllo. 

HelpProvider htmlHelpProvider = new 

HelpProvider(); 

html HelpProvider. SetShowHelp(btRead Me, true); 

htmlHelpProvider.HelpNamespace = 

"readme.htm"; 

Ricordate che se viene impostata la proprietà 
HelpNamespace allora la HelpString sarà 
ignorata e non verrà più visualizzata come 
Tooltip premendo il tasto FI o utilizzando 
THelpButton della Form, ma al suo posto 
verrà aperto il file di guida stesso. 
La HelpString sarà comunque accessibile per 
ogni evenienza invocando il metodo 
GetHelpString. 

Più interessante senza dubbio l'utilizzo dei 
file CHM, in quanto è possible associare ad 
ogni controllo dell'interfaccia una keyword, e 
quindi aprire la guida selezionando proprio la 
pagina che descrive la funzionalità desidera- 
ta. 

Per realizzare un file di guida CHM potete uti- 
lizzare sia tool commerciali, che il gratuito 
HTML Help Workshop di Microsoft. Non ci 
soffermiamo qui sulla realizzazione di un 
help, cosa che esula dai nostri scopi, ma uti- 
lizzeremo un file ehm qualunque. D'altronde, 
data la diffusione del formato ne trovate a 
decine in ogni installazione di Windows. 
Prendiamo ad esempio il file di guida di 
Notepad (notepad.chm), che dovreste ritro- 
varvi anche voi nella directory C:\Windows 
\Help. 

Se la proprietà HelpNamespace è stata impo- 
stata ad un percorso di un file di help, que- 
st'ultimo verrà visualizzato usando i parame- 
tri che devono essere impostati mediante il 
metodo SetHelpNavigator ad uno dei valori 



MICROSOFT HTML HELP 




Ctt 



' creare una guida in linea 
potete usare HTML Help 
Workshop, se non lo possedete, 
è scaricabile gratuitamente da 
microsoft.com, esattamente 
all'uri 



http://go.microsoft.com/fwlink/? 
Linkld=14188, insieme alla 
relativa documentazione che 
invece trovate all'uri 
http://go.microsoft.com/fwlink/? 
Linkld=14581. 
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dell' enumerazione Help Navigator, riassunti 
nell'elenco di seguito: 

• Associatelndex: apre Fhelp file alla prima 
lettera dell'argomento specificato. 

• Find: apre Fhelp alla pagina di ricerca 

• Index: apre Fhelp alla pagine dell'indice 

• KeywordIndex:apre Fhelp all'argomento 
dell'indice specificato se esiste, oppure a 
quello più vicino. 

• TableOfContents: apre il sommario del- 
l'help 

• Topic: apre lo specifico argomento se esiste. 

• Topicld: apre l'argomento identificato dal 
numero specificato. 

Supponiamo ad esempio di volere, alla pres- 
sione del tasto FI con il focus su un dato con- 
trollo, aprire il file notepad.chm, selezionan- 
do l'indice della guida stessa, ed esattamente 
in corrispondenza della parola chiave "testo", 
se esiste fra le keyword disponibili. In questo 
caso utilizzeremo i metodi SetHelpNavigator 
e SetHelpKeyword: 

HelpProvider chmHelp = new HelpProvider(); 
chmHelp.HelpNamespace = "notepad.chm"; 
ehm Help. SetHelpNavigator(btHelpIndex, 

HelpNavigator. Index); 
ehm Help. SetHelpKeyword(btHelpIndex, "ricerca"); 

Se si vuol aprire la guida posizionandosi ad un 
determinato sotto argomento, bisogna fornire 
il percorso dell'argomento nel file, che potete 
ottenere cliccando con il tasto destro, nella 
pagine dell'argomento stesso e poi cliccando 
su proprietà, quindi bisognerà utilizzare 
come HelpNavigator il parametro Topic, ad 
esempio: 



Associatelndex e quindi la lettere che interessa: 

ehm Help. SetHelpNavigator(btHelpIndex, 

HelpNavigator. Associatelndex); 
chmHelp. SetHelpKeyword(btHelpIndex, "a"); 

La classe HelpProvider utilizza internamente 
i metodi della classe Help, che fornisce allo 
sviluppatore solo metodi statici pubblici. La 
classe Help è naturalmente utilizzabile diret- 
tamente nel vostro codice. 
Vediamo come utilizzarla ad esempio per 
creare il classico menu di Help, con le voci 
Sommario, Indice e Cerca, e aprire il file guida 
posizionandolo proprio ad una delle tre voci. 
Per ottenere lo scopo, basta invocare il meto- 
do ShowHelp, con l'adeguato HelpNavigator 
ed eventualmente con una chiave di ricerca: 

private void sommarioToolStripMenuItem_Click 

(object sender, EventArgs e) 

S 

Help.ShowHelp(this, "notepad.chm", 

HelpNavigator. TableOfContents); 

_} 

private void indiceToolStripMenuItem_Click(object 

sender, EventArgs e) 

S 

Help.ShowHelp(this, "notepad.chm", 

HelpNavigator. Index); 

_} 

private void cercaToolStripMenuItem_Click(object 

sender, EventArgs e) 

S 

Help.ShowHelp(this, "notepad.chm", 

HelpNavigator. Find, "keyword"); 



ehm Help. SetHelpNavigator(btHelpIndex, 

HelpNavigator. Topic); 
chmHelp. SetHelpKeyword( 

btHelpIndex, "notepad.chm 
:/win_notepad_utf_description.htm"); 

Infine vediamo come aprire l'indice posizio- 
nandosi alla prima parola che inizia con una 
determinata lettera. È necessario in questo 
caso impostare il valore HelpNavigator. 



L'AUTORE 



Antonio Pelleriti, ingegnere 
informatico, si occupa di .NET sin 
dalle prime versioni Beta. 
Potete contattare l'autore per 
suggerimenti, critiche o 



chiarimenti all'indirizzo e-mail 
antonio.pelleriti@ioprogrammo.it, 
sul forum di ioProgrammo all'uri 
forum.ioprogrammo.net o sul sito 
web www.dotnetarchitects.it 



CONCLUSIONI 

Abbiamo mostrato come rendere le applica- 
zioni più user friendly, dotandole di un help in 
linea. Ciò è stato possibile utilizzando le clas- 
si ed i controlli previsti per tale scopo dal 
.NET framework, utilizzando Tooltip, 
StatusBar, ErrorProvider ed infine Help 
Provider per aprire file di help esterni. 
I metodi utilizzabili sono davvero tanti, e cor- 
redare un'applicazione di una serie di aiuti 
che ne migliorino l'usabilità, attribuisce al 
software un valore davvero elevato. Inoltre è 
molto probabile che risparmierete molto 
tempo in formazione e assistenza. Non vi 
resta che iniziare a pensare a dotare anche le 
vostre applicazioni di un help. 

Antonio Pelleriti 
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FILTRI GRAFICI 
IN JAVA 



QUESTO ARTICOLO ILLUSTRA COME CARICARE UN'IMMAGINE, VISUALIZZARLA IN UNA 
FINESTRA E APPLICARLE DIVERSI FILTRI PER OTTENERE EFFETTI GRAFICI INTERESSANTI, 
COME MARMO, OLIO O CRISTALLIZZAZIONE. 




LI CD U WEB 

FiltriGrafici.zip 



n& 



Con Java fare grafica avanzata è possibile? 
Certamente sì. In questo articolo mostre- 
remo come creare un'applicazione in 
grado di applicare una serie di filtri su immagini, 
né più né meno di quanto fa ad esempio 
Photoshop. Per i nostri scopi ci serviremo di una 
serie di librerie liberamente scaricabili dal sito 
ttp:// www.jhlabs.com/. Il nostro scopo sarà 
didattico. Quindi in un primo momento creere- 
mo un'interfaccia base, dalle quale saremo in 
grado di derivare tante applicazioni specializza- 
te ciascuna su un unico filtro. Perciò armiamoci 
di compilatore Java e di un buon IDE e iniziamo! 



CHE VUOL DIRE JHLABS? 



JH Labs è un sinonimo di Jerry 
Huxtable, un esperto sviluppatore 
Java che ha dedicato molte 
energie alla grafica e alla 
manipolazione delle immagini 
sulla piattaforma Java. Sul suo 
sito è possibile trovare diversi 
package Open Source e 
interessanti applicazioni, oltre ad 
alcune Applet che possono essere 
provate online. Tra le applicazioni 
si trovano un editor di immagini. 



che utilizza il package di filtri che 
viene illustrato nell'articolo, un 
visualizzatore di mappe, alcuni 
Layout Manager, un visualizzatore 
di font Unicode, alcuni giochi e 
altre cose interessanti, come 
un'Applet per creare animazioni di 
particelle, per intenderci quelle 
utilizzate per simulare fiamme o 
fuochi d'artificio e utilizzati anche 
negli effetti speciali 
cinematografici. 



ne sarà affidata a un oggetto JLabel, che in 

Swing implementa una semplice etichetta di 

testo. 

Alla JLabel verrà anche associato un bordo, in 

modo da ottenere un simpatico riquadro che 

renda l'idea di una foto stampata. 

La dichiarazione della classe è la seguente: 



/* 



ImageFilterTestBed 



*/ 



package it.edmaster.ioprogrammo.filtrigrafici; 



import java.awt.BorderLayout; 



import java. awt. Color; 



import java. awt. image.Bufferedlmage; 



import java.io.IOException; 



import javax.imageio.ImagelO; 



import javax. swing. Bo rd e r Factory; 



import javax. swing. Imagelcon; 



import javax. swing. JFrame; 



import javax. swing. JLabel; 



import javax. swing. border.Border; 



* Classe generica per la prova dei filtri. Produce 

* una rappresentazione dell'immagine basata su una 

* finestra JFrame 



* @author mbigatti 



jn 




REQUISITI 



Conoscenze richieste 



Linguaggio Java 




Tempo di realizzazione 



000 



UNA CLASSE PER I TEST 

Per provare il funzionamento dei filtri grafici, 
di cui parliamo in questo articolo, creeremo 
una classe di prova che fungerà da contenito- 
re di tutto il codice che farà da supporto 
necessario alle operazioni di filtraggio. Questa 
classe si chiama ImageFilterTestBed ed è 
dichiarata astratta. Nelle sottoclassi inserire- 
mo il codice dei filtri da cui passerà Timmagi- 
ne prima di essere visualizzata. 
La visualizzazione si baserà su un normale 
JFrame a cui assoceremo un Layout Manager 
BorderLayout. La presentazione deirimmagi- 



*/ 



public abstract class ImageFilterTestBed { 

l'unico attributo è un oggetto di tipo JFrame, 
che rappresenta la finestra in cui è visualizza- 
ta l'immagine: 

/** finestra */ 
JFrame frame; 

il costruttore non fa altro che richiamare il 
metodo createUIO, che si occupa di creare 
l'interfaccia utente: 
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/** 



* Crea la finestra 



@throws IOException 



V 



public ImageFilterTestBedO throws 

IOException { 



createUIQ; 



> 



metodo getFilterName(). Viene poi tolta la 
possibilità di ridimensionare la finestra. Viene 
impostato il Layout Manager BorderLayout. 
Poi viene aggiunta Y etichetta. La chiamata al 
metodo pack() ridimensiona la finestra in 
modo che la dimensione sia la minore possi- 
bile. La chiamata a setVisibleO visualizza la 
finestra: 




Il METODO CREATEUK) 

Come già detto, si tratta del metodo che viene 
richiamato nel costruttore e serve a creare 
l'interfaccia utente. Vediamolo nel dettaglio. 
La prima operazione che eseguirà sarà legge- 
re dal CLASSPATH un'immagine. Lo farà 
attraverso le API Image I/O. Nel nostro esem- 
pio l'immagine si chiama IMG_5950.jpg e per 
caricarla si ottiene per prima cosa un URL che 
fa riferimento alla posizione fisica del file 
attraverso il metodo getResource(): 



* Crea l'interfaccia utente 

* @throws IOException 

*/ 



void createUI() throws IOException { 

//carica l'immagine dal classpath 
Bufferedlmage image = 
ImageIO.read(getClass().getResource 
("/IMG_5950.jg")); 



l'immagine viene poi passata al metodo Al- 
ter (), che ne esegue la manipolazione. Il risul- 
tato viene passato ad un nuovo oggetto 
Imagelcon, attraverso il metodo setlmage(): 

//esegue il filtro e crea una icona da 
//associare all'etichetta 

image = filter((BufferedImage) image); 
Imagelcon icon = new ImageIcon(); 
icon.setlmage(image); 

in seguito viene creata l'etichetta e impostato 
un bordo costruito nel metodo create 
BorderO, che verrà illustrato in seguito: 

//crea l'etichetta e aggiunge il bordo 

JLabel label = new JLabel(icon); 
label. setBorder( createBorder() ); 

il passaggio finale consiste nelFistanziazione 
di un oggetto JFrame, nel cui titolo viene pas- 
sato il nome del filtro. Questo è ottenuto dal 



//crea la finestra, aggiunge l'immagine e la 

visualizza 
frame = new JFrame("Filtro " + 

getFilterNameO); 
frame. setResizable(false); 
frame. getContentPane().setl_ayout( new 

BorderLayoutQ ); 



DIFFERENZE FRA AWT E SWING 



[Diversamente da AWT, in Swing le 
etichette possono includere anche 
immagini. In questo caso si parla 
di icone, definite da oggetti di 



interfaccia Icon. Una classe 
concreta che implementa Icon è 
Imagelcon, a cui è possibile 
passare un oggetto di tipo Image. 



frame. getContentPane().add(label); 


frame. pack(); 


frame. setVisible(true); 


} 



Creare il bordo dell'etichetta è un'operazione 
leggermente complessa, perché sfrutteremo 
la combinazione di diversi bordi. Il codice 
relativo è scritto nel metodo createBorder(). 
Per prima cosa viene creato un bordo esterno 
di 20 pixel su ciascun lato, assegnato alla 
variabile space. Poi viene creato un bordo 
bianco di 15 pixel che verrà utilizzato per con- 
tornare la fotografia. Poi vengono creati due 
bordi grigi di intensità diversa, che vengono 
combinati in modo tale da ottenere un effetto 
di tridimensionalità. Questo bordo combina- 
to viene ottenuto con il metodo create 
CompoundBorder(). Il bordo grigio viene poi 
combinato con quello bianco, e il risultato 
viene unito con il bordo esterno: 

/** 

* Crea il bordo della fotografia, 

* combinando diversi bordi 

* @ return 

V 

Border createBorderQ { 



//spazio esterno 



Border space 



BorderFactory. 



createEmptyBorder(20, 20, 20,20); 
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//interno bianco 



Border mu 



BorderFactory.createLineBorder(Color.WHITE,15); 



//lineee 



Border bl 



BorderFactoryxreateMatteBorder( 1,1, 0,0, Color. LIGH 

_GRAY); 



Border b2 



BorderFactory.createMatteBorder(0,0,l,l,Color.GRAY; 



Border ri 



BorderFactory.createCompoundBorder(bl, b2); 



Border r2 



BorderFactory.createCompoundBorder(rl, mu); 



Border r3 



BorderFactory.createCompoundBorder(space, r2); 



return r3; 



} 



La classe si conclude con due metodi astratti, 
che dovranno essere ridefiniti nelle sottoclas- 
si. Il metodo filter() si aspetta un parametro di 
tipo Bufferedlmage e ritorna un valore dello 
stesso tipo. Questo metodo esegue la modifi- 
ca dell' immagine. L'altro metodo astratto è 
getFilterName(), che ritorna il nome del filtro. 
Questa è una semplice descrizione utilizzata 
nel titolo della finestra. 



utilizzerà alcun filtro. L'immagine verrà quin- 
di presentata senza modifiche, così come è 
salvata nel file di prova. Questa classe di prova 
si chiamerà NoFilter, ed estenderà la 
ImageFilterTestBed. Essendo una classe con- 
creta, deve implementare i metodi filter() e 
getFilterName(). Il primo metodo non farà 
altro che ritornare il parametro, senza modifi- 
carlo. In questo modo l'immagine da visualiz- 
zare sarà la medesima di quella in ingresso. Il 
metodo getFilterName() ritornerà semplice- 
mente il valore "Neutro". Oltre a questi due 
metodi saranno presenti un costruttore e il 
metodo main(). Il primo non farà altro che 
creare il costruttore della superclasse, che 
esegue la creazione della finestra e il carica- 
mento deirimmagine. Il metodo main() non 
farà altro che istanziare un oggetto di tipo 
NoFilter: 

/## 
* NoFilter 

J7 

package it.edmaster.ioprogrammo.filtrigrafici; 

import java. awt.image. Bufferedlmage; 
import java.io.IOException; 



/* 



Esegue la manipolazione dell'immagine 



@param image 



@ return 



*/ 



public class NoFilter extends ImageFilterTestBed { 



public NoFilterQ throws IOException { 



super(); 



abstract Bufferedlmage filter(BufferedImage 

image); 



/* 



* Ritorna il nome del filtro da visualizzare 



* nel titolo della finestra 



@ return 



*/ 



abstract String getFilterName(); 



Bufferedlmage filter(BufferedImage image) 



return image; 



} 



String getFilterName() { 



return "Neutro" 



{ 



UHI PROGRAMMA 
DI PROVA 

Quello che faremo ora sarà creare una classe 
derivata da ImageFilterTestBed, che però non 



FILTRI BASE 



La libreria di filtri di JH Labs 
dispone anche di filtri di base, 
I che replicano e integrano quelli 
I presenti nella piattaforma Java. 
Questi includono il blur. 



inversione di colore e altri. 
Diversamente da quelli 
predefiniti, i filtri JH Labs 
offrono più parametri di 
configurazione. 



@param args 



@throws IOException 



V 



public static void main(String[] args) throws 

IOException { 



new NoFilterQ; 



} 



} 



Il risultato sarà quello visibile in Figura 1. 
Come si vede, l'immagine è riquadrata da un 
bordo bianco, all'esterno del quale è presente 
il filo nelle due tonalità di grigio. Questo è 
ulteriormente spaziato dal bordo della fine- 
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Fig. 1. Visualizzazione dell'immagine senza manipola- 
zioni 

stra. Si noti che non è possibile ridimensiona- 
re la finestra, in quanto è stato impostato il 
flag resizable a false sulla JFrame. Questo 
accorgimento è dovuto al fatto che per effetto 
del Layout Manager utilizzato, il bordo bianco 
non sarebbe rimasto aderente airimmagine, 
ma al bordo della finestra. Si sarebbe dunque 
ottenuto un effetto sgradevole. 
Si noti che per funzionare è necessario avere, 
nella root del CLASSPATH, l'immagine di 
prova IMG_5950.jpg. 



INTEGRARE I FILTRI 

A questo punto è necessario scaricare i filtri 
dal sito http://www.j hlabs.com/ip/filters/ 
download.html . Il file zip che scarichermo con- 
tiene sia i sorgenti sia il file JAR da includere 
nel proprio progetto. Inoltre è presente un file 
di Ant per ricompilare i sorgenti e ricreare il 
file Filters.jar. 

Il primo filtro che verrà provato è il filtro mar- 
morizzatore, il cui effetto sull'immagine di 
prova è illustrato in Figura 2 




La classe che produce questa finestra si chia- 
ma Marmo. Il suo codice sorgente è il seguen- 
te: 

package it.edmaster.ioprogrammo.filtrigrafici; 
import java.awt.image.Bufferedlmage; 
import java.io.IOException; 
import com.jhlabs.image.MarbleFilter; 
public class Marmo extends ImageFilterTestBed { 
public Marmo() throws IOException { 
super(); 



Bufferedlmage filter(BufferedImage image) 

{_ 

MarbleFilter filter = new 

MarbleFilterO; 
Bufferedlmage dest = filter 
.createCompatibleDestImage(image, 
image. getColorModel()); 
filter.filter(image, dest); 
return dest; 

_} 

String getFilterl\lame() { 

return "Marmorizza"; 



* @param args 

* @throws IOException 

V 

public static void main(String[] args) throws 

IOException { 
new Marmo(); 

} 

} 



Come si vede, la struttura è simile a NoFilter. 
Gli elementi peculiari sono contenuti nel 
metodo filter () e getFilterName(). Il secondo 
si limita a ritornare la descrizione 
"Marmorizza". Il primo esegue questa volta la 
manipolazione dell'immagine. 
Il filtro utilizzato è MarbleFilter, presente nel 
package com.jhlabs.image. I passaggi per l'u- 
tilizzo di questi filtri sono pochi e omogenei 



APPLICAZIONI COMPLETE 




In tutte le applicazioni 
destinate alla versione 
2.0 è consigliabile 
utilizzare le nuove 
classi di insiemi 
generiche anziché 
le controparti non 
generiche meno 
recenti, quale Array List 



Fig. 2. Immagine sottoposta al filtro marmorizzato 



Sul sito di JH Labs è disponibile 
una interessante applicazione, 
chiamata Java Image Editor 

( http://www.jhlabs.com/ie/index.ht 



mi) che implementa un semplice 
programma di manipolazione 
immagini che si basa sui filtri 
descritti nell'articolo. 



Il vantaggio di utilizzare 
l'applicazione Java Image Editor 
è che esistono pannelli di 
configurazione per ciascun 
filtro, che permettono di variare 
tutti i parametri di un dato 
filtro visualizzandone 
un'anteprima. 
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per le diverse tipologie di filtro. Questi sono: 
l.Istanziare il filtro creando un oggetto del 

tipo voluto. In questo caso il filtro è 

MarbleFilter. 

2. Ottenere un'immagine di output per le ope- 
razioni di filtro. La si può produrre utiliz- 
zando il metodo createCompatible 
DestlmageO presenti sull'oggetto filtro. A 
questo metodo va passata un'immagine di 
riferimento e un modello di colore. Il primo 
parametro non è altro che il parametro 
Bufferedlmage passato al metodo filter() da 
noi creato. Il modello di colore può essere 
invece ottenuto utilizzando il metodo 
getColorModelO presente nella classe 
Bufferedlmage. 

3. Impostare eventuali opzioni sul filtro (in 
questo esempio non ne sono state imposta- 
te). 

4. Chiamare il metodo filter() sull'oggetto fil- 
tro, passando l'immagine di partenza e 
quella di destinazione prodotta nel punto 2. 

L'immagine di destinazione viene poi riporta- 
ta come risultato dal metodo. 



i margini come si può vedere in Figura 2. 

Il filtro in questo caso è OilFilter e il codice 

sorgente è similare al precedente: 

package it.edmaster.ioprogrammo.filtrigrafici; 
import java. awt.image. Bufferedlmage; 
import java.io.IOException; 



import com.jhlabs.image. OilFilter; 



public class Olio extends ImageFilterTestBed { 
public OlioQ throws IOException { 



super(); 



} 



Bufferedlmage filter(BufferedImage image){ 



OilFilter filter = new OilFilterQ; 



Bufferedlmage dest = 



filter.createCompatibleDestImage(image, 

image. getColorModelO); 



filter.filter(image, dest); 



return dest; 



} 



String getFilterNameQ { 



return "Olio"; 



@param args 



GIOCARE CON I FILTRI 

Ora che abbiamo visto come operare con un 
semplice filtro, vediamo altri esempi, anche di 
complessità crescente. Il prossimo filtro ana- 
lizzato riproduce l'aspetto di un dipinto ad 
olio. Cambia i colori dell'immagine, sfocando 




Fig. 3. Immagine sottoposta al filtro olio 



ESTENDERE JAVA IMAGE EDITOR 



È possibile scrivere plug-in per Java 
Image Editor, utilizzando la 
documentazione descritta alla 
pagina http://www.jhlabs.com/ie/ 
jplugin.html. Può essere una sfida 



interessante, che permetterebbe di 
sfruttare un'applicazione esistente 
e funzionante per utilizzare il 
proprio filtro o componente di 
trattazione delle immagini. 



@throws IOException 



*/ 



public static void main(String[] args) throws 

IOException { 



new OlioQ; 



} 



GESTIONE 



Sebbene non siano stati utilizzati negli esem- 
pi precedenti, tutti i filtri dispongono di meto- 
di per impostare o recuperare i parametri di 
funzionamento. Data la quantità di parametri 
disponibili è possibile una grande variabilità 
di risultati. In alcuni casi il risultato di un fil- 
tro, portato ai suoi limiti, produce un risultato 
simile a un altro filtro utilizzato con i parame- 
tri di default. 

Il prossimo esempio utilizza il filtro 
CrystallizeFilter, che produce un effetto di cri- 
stallizzazione deirimmagine. L'output dell'e- 
sempio è illustrato in Figura 4. 
La manipolazione non utilizza i valori di 
default, in quanto nel codice è presente Firn- 
postazione di alcune opzioni. Il codice sor- 
gente della classe Cristallizza, che impiega 
questo filtro, è il seguente: 
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Questo indica al filtro di utilizzare una griglia 
composta da ottagoni e quadrati. Ovviamente 
si sarebbe potuto passare solo OCTAGONAL o 
SQUARE, oppure una delle altre costanti defi- 
nite nella classe. Queste costanti contengono 
dei valori che è possibile combinare in modo 
binario. In questo caso è stata compiuta un'u- 
nione con l'operatore |. L'altro parametro 
impostato è il valore di scala, che indica la 
dimensione di ciascun tassello che compone 
il risultato finale. Si noti che questo filtro offre 
anche altre opzioni, che non sono state utiliz- 
zate. 



CONCLUSIONI 

La libreria di filtri di JH Labs è molto interes- 
sante e completa. 

Qui sono stati provati quattro filtri, apparte- 
nenti alla tipologia di quelli che cambiano lo 
stile dell'immagine. Ma questa libreria offre 
molto di più, a partire dai filtri blur e di corre- 
zione del colore. La prima categoria individua 
filtri di sfocatura e racchiude circa una dozzi- 
na di filtri. Un esempio di Motion Blur è illu- 
strato in Figura 5. 





Fig. 4. Immagine sottoposta al filtro cristallizzazione 



package it.edmaster.ioprogrammo.filtrigrafici; 
import java.awt.image.Bufferedlmage; 
import java.io.IOException; 
import com.jhlabs.image.CrystallizeFilter; 
public class Cristallizza extends ImageFilterTestBed { 
public Cristallizza() throws IOException { 
super(); 



Bufferedlmage filter(BufferedImage image){ 
CrystallizeFilter filter = new 

CrystallizeFilter(); 
Bufferedlmage dest = 
filter.createCompatibleDestImage(image, 

image.getColorModelO); 
filter.setGridType(CrystallizeFilter.OCTAGONAL | 

CrystallizeFilter.SQUARE); 

filter.setScale(15.8f); 

filter.filter(image, dest); 
return dest; 



String getFilterl\lame() { 

return "Cristallizza" 




Fig. 5. Immagine sottoposta al filtro Motion Blur 



@param args 



@throws IOException 



*/ 



public static void main(String[] args) throws 

IOException { 



new Cristallizza(); 



} 



> 



Come si vede la struttura della classe è identi- 
ca agli esempi precedenti, ma questa volta 
sono state impostate due opzioni. La prima è 
il tipo di griglia, che è il risultato dell'unione 
delle due costanti OCTAGONAL e SQUARE. 



La seconda categoria permette la manipola- 
zione dei colori dell'immagine. 
Anche in questo caso i filtri disponibili sono 
molteplici, più di una dozzina. Oltre a questi 
sono disponibili filtri che implementano 
Texture, che producono effetti (cromo, spec- 
chio, feedback e glint) e per la distorsione 
delle immagini. In questo ultimo gruppo sono 
presenti filtri per introdurre bordi, distorsioni 
a forma di sfera, a diffusione, a cerchio, ecce- 
tera. 

I filtri presenti sono moltissimi, quindi non 
resta altro che... sperimentare! 

Massimiliano Bigatti 
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SUL CD 



AXIS1.4 

IL FRAMEWORK PER CREARE WEB 
SERVICES IN JAVA 

I Web Services rappresentano il futuro 
della programmazione. Sostanzialmente 
si tratta di miniapplicazioni che girano 
allo stessa stregua di un'applicazione web 
ma che esportano interfacce consumabili 
da client. Il linguaggio comune fra client è 
web services è SOAR ovvero uno standard 
un protocollo standard su cui si basa lo 
scambio dei messaggi fra le parti. Ma 
come si crea un web services? Per quanto 
riguarda Java ci viene incontro questo 
interessante framework, prodotto, come 
spesso accade, dall'insostituibile Apache 
Foundation. Axis viene installato come 
un'application di Tomcat e a questo punto 
mette a disposizione interessanti metodi 
per la creazione facilitata dei web services 
e dei loro consumer 
Directory:/Axis14 

CAYENNE 1.2 

IL NUOVO OBJECT 
RELATIONAL MAP 

Noi programmatori siamo abituati a pen- 
sare ad oggetti tranne quando abbiamo a 
che fare con SQL. Il linguaggio standard 
dei database è abituato a lavorare per 
righe, celle e colonne, concetti che poco 
hanno a che fare con i nostri comodissimi 
oggetti e classi. Per ovviare a questo incon- 
veniente sono nati gli Orbs. Tool interme- 
di che convertono dinamicamente tabelle, 
colonne, righe e celle, in classi ed oggetti. 
Cayenne è un tool emergente che appar- 
tiene a questa categoria e di cui ci parla 
Ivan Venuti in questo stesso numero di 
ioProgrammo. 
Directory:/ Cayenne 

ECLIPSE SDK 3.1.2 

L'AMBIENTE APERTO 

Eclipse è un IDE "Aperto" multipiattafor- 
ma e completamente scritto in Java. Per 



aperto si intende un sistema che può esse- 
re facilmente espandibile per mezzo di 
moduli. Perciò se da un lato inizialmente 
si presenta pronto per favorire lo sviluppo 
di applicazioni Java, dall'altro lato tramite 
moduli può diventare un comodo IDE per 
PHP oppure per C++ oppure per XML, 
oppure per qualunque altro linguaggio 
che sia supportato da un modulo. In que- 
sto numero di ioProgrammo lo abbiamo 
utilizzato in più occasioni ed è ormai 
diventato uno standard per ogni program- 
matore Java. 
Directory:/ EclipseSDK312 

ITEXT SHARP 3.1.1 

IL PDF È FATTO 

iText è una libreria OpenSource scritta in 
Java che consente di dotare le nostre 
applicazioni di funzionalità di esportazio- 
ne verso il formato PDF. Si tratta di una 
libreria decisamente importante. Il PDF è 
un formato universale che garantisce una 
grande precisione nella stampa e una por- 
tabilità senza precedenti. Il poter creare 
documenti in formato PDF da una nostra 
applicazione sicuramente ne innalza il 
valore. D'altra parte itext non solo gestisce 
la mera esportazione dei dati in formato 
PDF ma dispone di funzionalità specifiche 
per crittografare o firmare digitalmente i 
documenti così creati. In questo numero 
vi presentiamo il porting della libreria 
verso .NET per poterla utilizzare in appli- 
cazioni C#. 
Directory:/ iTextSharp 

JAVA DEVELOPMENT 
KIT 1.5.0 UPGRADE 7 

INDISPENSABILE PER 
PROGRAMMARE IN JAVA. 

Ci corre l'obbligo, prima di tutto, di fare i 
nostri migliori auguri a java che ha appena 
compiuto 10 anni di vita. Il linguaggio di 
Sun nato con l'ambizione di essere il 
primo realmente multipiattaforma e che 



portava con se la grande ambizione di ser- 
vire qualunque tipo di periferica, dopo 10 
anni di esistenza può dire di avere larga- 
mente realizzato i suoi obiettivi. Con una 
base di programmatori larghissima e con 
il primato invidiabile di essere il linguag- 
gio base per i telefonini di nuova genera- 
zione come per i PC come per i sistemi 
embedded è ad oggi uno dei linguaggi più 
diffusi al mondo. Per programmare in Java 
è necessario semplicemente dotarsi del 
J2SE che vi presentiamo in questo stesso 
numero 
Directory:/ J2SE50Update7 

JCAPTCHA 1.0RC3 

REGISTRAZIONI SICURE SUI SITI WEB 

State per registrarvi su un sito web, e assie- 
me alle informazioni di registrazione vi 
tocca ricopiare nella form anche un codi- 
ce riprodotto nel sito su una jpeg. Quello è 
un Captcha. In questo numero di 
ioProgrammo vi proponiamo un articolo 
di Ivan Venuti che mostra come creare un 
web services che consente a qualunque 
sito di implementare questa funzionalità. 
L'articolo è basato appunto su JCaptcha, 
questa interessante, quanto leggera libre- 
ria OpenSource scritta in Java che mette a 
disposizione appunto funzionalità per la 
creazione di Captcha. 
Directory:/ JCaptcha 

MYSQL MIGRATION 
KIT 1.0.25 

MIGRA I DATI A MYSQL IN UN CLIC 

MySQL si sta sempre affermando di più 
come uno standard de facto nel campo dei 
database. Sempre più frequente si manife- 
sta la volontà di passare le proprie applica- 
zioni dall'uso di un particolare DB a 
MySQL. Ad esempio è il caso di Access, 
SQL Server, Oracle, ciascuno dei quali in 
particolari condizioni si rivela inadeguato 
per un certo tipo di applicazione. Da oggi 
la migrazione è semplificata con questo 
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MySQL Migration Kit che con una proce- 
dura semplificata consente di passare 
facilmente da un formato di database ad 
un altro. 
Directory:/ MySQLMigration1025 

MYSQL 
ADMINISTRATOR 

L CERVELLO DI MYSQL 

Un buon database non si basa solo sulle 
performance o sulle funzionalità , ma deve 
anche essere semplice da amministrare, la 
dove per amministrazione si intende la 
creazione di nuovi utenti, la gestione dei 
permessi sulle tabelle, la creazione delle 
repliche e il tuning del sistema. Tutto que- 
sto si traduce in complessità di ammini- 
strazione. MySQL Administrator è una 
comodissima interfaccia grafica che vi 
consente di eseguire praticamente tutte le 
operazioni di gestione del database, dalla 
creazione al backup, alla gestione delle 
statistiche e dei log, svincolandovi da tutte 
quelle che sono le limitazioni di un'inter- 
faccia a linea di comando. 
Directory:/ MySQLAdmnistrator 

MYSQL 5.0.21 

IL DB PIÙ USATO SUL WEB 

In congiunzione a PHR MySQL fa girare 
buona parte del Web. Non c'è applicazio- 
ne PHP che non utilizzi in qualche modo 
MySQL per gestire e recuperare i dati. Una 
così enorme diffusione si può giustificare 
solo con la bontà del prodotto. Infatti 
MySQL è un database estremamente leg- 
gero, gratuito, facile da usare e configura- 
re. Si certo, manca ancora di qualcuna 
delle raffinatezze che fanno degli altri 
database dei mostri sacri per la program- 
mazione in ambiente business, tuttavia 
anche questo gap va lentamente colman- 
dosi. Per questi motivi MySQL sta rapida- 
mente scalando posizioni anche nella pro- 
grammazione di applicazioni standalone, 
anche se il suo ambito di riferimento pri- 
mario rimane il web. In questo numero di 
ioProgrammo vi dedichiamo un megaarti- 
colo che mostra come ottimizzare alcuni 
aspetti di MySQL per rendere le vostre 
applicazioni estremamente veloci. 
Directory:/ MySQL5021 

MYSQL QUERY 
BROWSER 1.1.20 

IL TOOL PER NAVIGARE FRA GLI 
OGGETTI DI MYSQL 

Come eseguire query senza dover interagi- 



re con la scomoda linea di comando di 
MySQL? Allo stesso modo, come navigare 
fra le tabelle di MySQL, cercare dati etc? 
ecco che ci viene incontro MySQL Query 
Browser, una potente interfaccia grafica 
che ci mette a disposizione numerosi stru- 
menti per la gestione dei dati. Si tratta di 
un tool piuttosto interessante, anche se 
non ha la complessità di phpMyAdmin, 
tuttavia la sua natura di applicazione 
Standalone lascia intravedere ampi margi- 
ni di miglioramento 

NICKEL AMD DIME 
COMTEIUT 
MANAGEMENT 
SYSTEM 

UN CONTENT MANAGEMENT 
SYSTEM SCRITTO IN ASRNET 

Interessante questo CMS che implementa 
una serie di caratteristiche avanzate, come 
una granulare gestione degli utenti, un 
editor WYSIWIG un template manager, un 
search engine e ancora molto altro. Il cms 
usa un'interfaccia intermedia che gli con- 
sente di utilizzare qualunque database in 
modo del tutto trasparente all'utente. In 
questo modo è possibile utilizzarlo su 
hosting che mettono a disposizione la 
piattaforma Microsoft ma non SQL Server, 
ovvero la stragrande maggioranza 
Directory:/ ndcms 



Ruby on 
rails 

IL FRAMEWORK VINCITORE DEL 
PREMIO "BEST TOOL" DEL 2006 

Chi lo avrebbe mai detto che 
un f ramework basato su Ruby 
avrebbe vinto un premio così 
prestigioso? Ed invece ad anni 
di distanza dalla presentazione 
di Ruby, ecco arrivare un pre- 
mio che lo consacra fra i lin- 
guaggi più interessanti della 
rete. Ruby On Rail è un f ra- 
mework per lo sviluppo di 
applicazioni Web, solide e affi- 
dabili. Soprattutto la bassa 
curva di apprendimento di 
Ruby e l'ottima progettazione 
del framework ne fanno un'ac- 
coppiata molto interessante 



NANT 0.85 

L'ASSEMBLATORE DI PROGETTI 

Nant è un tool che consente di costruire 
un processo automatico per la generazio- 
ne di applicazioni. Da utilizzare quando 
un prodotto è suddiviso in molte dll o sot- 
toprodotti gestiti da reparti separati, nant 
crea una specie di processo batch che rac- 
coglie i file dalle directory dei singoli svi- 
luppatori, li compila e li predispone per la 
costruzione di un'applicazione completa. 
Si tratta dell'omologo di Ant per Java e 
risulta molto comodo in progetti di grandi 
dimensioni, oppure quando si fa riferi- 
mento a una serie di DLL che interagisco- 
no fra loro. 
Directory:/ Nant 

POSTGRES SQL 8.1.4 

COMPLETO E OPENSOURCE 

Fra i database OpenSource non ne abbia- 
mo trovato ancora uno in grado di compe- 
tere per quantità di funzioni implementa- 
te! e a dire il vero pochi sistemi commer- 
ciali reggono il confronto con PostgreSQL. 
Al di là della velocità e dell'affidabilità del 
prodotto sono le sue caratteristiche ad 
averci impressionato. Foreign Keys, stored 
procedure, view, ereditarietà delle tabelle 
sono solo alcune delle caratteristiche che 
fanno di PostgreSQL un database comple- 
to. Particolarmente interessante è l'esten- 
dibilità del prodotto a mezzo di moduli 
esterni. Ne esistono già tantissimi che 
implementano praticamente tutto lo sci- 
bile sui database. Le caratteristiche inter- 
ne al db più quelle aggiunte da moduli 
esterni ne fanno un prodotto completo e 
fuori dal comune. 
Directory:/ PostgreSQL 

PGADMini 3.1.4.2 

L'INTERFACCIA DI GESTIONE DI 
POSTGRES 

Che PostgreSQL sia un database ecce- 
zionalmente potente è ormai noto. 
Purtroppo a tanta potenza corrispon- 
de naturalmente una certa comples- 
sità nelL amministrazione delle tante 
caratteristiche che il prodotto espone. 
Per non perderci all'interno delle 
varie opzioni e delle possibilità di 
configurazione di PostGreSQL ecco 
che ci viene incontro PGAdmin, una 
comoda interfaccia di gestione che 
consente di amministrare l'intero 
database e tutte le sue caratteristiche 
più avanzate in modo visuale, senza 
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dover ricorrere alla scomoda linea di 

comando 

Directory:/ PGAdmin 

PHP 5.1.4 

IL LINGUAGGIO DI INTERNET 

Si tratta del linguaggio con il quale sono 
sviluppate la maggior parte delle applica- 
zioni internet esistenti. La curva di 
apprendimento è bassissima, le funziona- 
lità esposte elevatissime, certamente se 
avete intenzione di sviluppare per il web 
non potrete fare a meno di provare anche 
questo linguaggio come base per le vostre 
applicazione. Attualmente la versione 
5.1.4 espone un modello ad oggetti piutto- 
sto completo che rende PHP un linguaggio 
moderno e persino didattico per chi vuole 
imparare a programmare ad oggetti senza 
dover affrontare la complessità di Java o 
.NET 
Directory PHP 5.1.4 

PYTHON 2.4.3 

IL LINGUAGGIO EMERGENTE 

Un linguaggio di scripting, multipiattafor- 
ma, orientato agli oggetti. Tre caratteristi- 
che che rendono questo linguaggio piutto- 
sto appetibile. Non per niente tutte le clas- 
sifiche mondiali sulla diffusione dei lin- 
guaggi di programmazione lo individuano 
come quello maggiormente in ascesa. 
Python è elegante, estensibile, con una 
curva di apprendimento non elevatissima. 
Viene utilizzato per programmare moltis- 
simi tool di gestione dei sistemi Unix, ma 
sta trovando una rapida applicazione 
anche sui sistemi Windows e nello svilup- 
po di applicazioni crossplatform. Python 
recentemente sta diventando davvero un 
punto di riferimento fisso per moltissimi 
sviluppatori. 
Directory:/Python 

SPRIHIG 1.2.8 

IL FRAMEWORK CHE 
LI RACCHIUDE TUTTI 

In questo numero lo utilizziamo per 
costruire un guestbook piuttosto partico- 
lare. Nell'articolo del bravo Ivan Venuti si 
mostra come implementare il pattern 
MVC con Spring. Si tratta di un framework 
che sta ottenendo un grande successo, per 
due motivi fondamentali. Prima di tutto 
raccoglie sotto un unico cappello una 
serie di tecnologie già esistenti, donando- 
gli però una certa interoperabilità e una 
forma omogenea. Secondo, implementa 



perfettamente il pattern Inversion Of 
Control che consente un alto grado di 
disaccoppiamento tra le classi di modo 
che la modifica di una non cambi il com- 
portamento di molte altre. Si tratta di un 
pattern molto interessante, per quanto sia 
investito di una certa complessità. 
Directory:/Spring128 

MYSQL CONNECTOR 

IL PONTE VERSO I LINGUAGGI 

Un database da solo non sarebbe niente se 
non fosse possibile sviluppare applicazio- 
ni che consentano di immagazzinare e 
manipolare i dati. 

Le applicazioni sono fatte dai linguaggi di 
programmazione. Per cui deve esistere 
qualcosa per collegare i linguaggi al data- 
base, nel caso di MySQL questo software 
"ponte" prende il nome di connectors, in 
questo numero presentiamo quello per 
Java e quello per .NET, per PHP il connec- 
tors è già integrato nel linguaggio, per tutti 
gli altri c'è ODBC il driver universale per i 



Ruby 1.8.2 

IL NUOVO CHE AVANZA 

E' così quest'anno il premio 
come miglior prodotto dell'anno 
va a RubyOnRail un framework 
basato su Ruby. Quando qualche 
anno fa questo linguaggio fece 
la sua comparsa sul mercato, 
nessuno gli diede molto credito. 
Ad oggi si presenta come un lin- 
guaggio di scripting eccezionale 
che condensa in un'unica solu- 
zione un modello ad oggetti 
completo, una curva di apprendi- 
mento che rasenta quasi lo zero 
assoluto, un alta integrazione 
con gli oggetti com di Windows, 
e altre elementi ancora. 



database. 

Directory:/ MySQLConnector 

TOMCAT 5.5.17 

L'APPLICATION SERVER PER JSP 

Se siete dei programmatori JSP avete 
senza dubbio bisogno di Tomcat per 
testare e utilizzare le vostre applicazio- 
ni. E' senza dubbio un server web ovve- 
ro può funzionare da server web ma è 



soprattutto un Application Server che vi 
consente di utilizzare la tecnica delle 
servlet o delle JSP per creare applicazio- 
ni Web con una logica business e con il 
linguaggio Java a fare da asse portante. 
Tomcat ha in se anche un Web Server, 
ma quel che più conta è un container di 
applicazioni Java. 
D i rectory :/Tomcat 

RAD RAILS 0.6.3 

L'AMBIENTE PER LO SVILUPPO DI 
APPLICAZIONI BASATE SU 
RUBYONRAILS 

Utile e ben fatto questo ambiente RAD 
interamente basata su Ruby On Rails, va 
a completare un trittico dalle incredibi- 
li potenzialità per chi vuole sperimen- 
tare linguaggi alternativi ma molto ben 
strutturati per lo sviluppo di web appli- 
cation 
Directory:/ RadRails 

YETANOTHERFORUM 
1.0.1 

ANCORA UN ALTRO FORUM! 

Il gioco di parole si presta bene per mar- 
care la vocazione OpenSource di questo 
progetto. Di fatto, tipicamente questo 
genere di gioco di parole viene applicato 
proprio a software OpenSource. 
YetAnotherForum è un forum scritto 
interamente in .NET. Il progetto è piutto- 
sto ambizioso e si pone sulla scia di pro- 
getti ben più noti quali phpBB. Tuttavia è 
importante notare oltre alle qualità 
intrinseche di questo forum che sono 
veramente eccellenti, quanto anche in 
ambienti .NET si stia cominciando a 
diffondere il concetto di OpenSource. 
Di rectory :/yetanotherforum 

TBLOGGER 0.23 

UN BLOG INTERAMENTE SCRITTO IN 
.NET 

Interessante questo piccolo sistema di 
blog scritto son il .NET framework. Certo 
non si può dire che sia un sistema com- 
pleto, anzi a dire il vero si tratta di un blog 
molto semplice, ma assolve a due funzio- 
nalità. La prima interamente didattica, di 
fatto la semplicità del codice si pone come 
un ottima base per comprendere come si 
possano sviluppare sistemi di questo 
genere. La seconda ovviamente in sistemi 
di produzione la dove non si necessitino di 
funzionalità troppo elevate. 
Directory:/ Tblogger 
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ALBERI: IMPARIAMO 
COME BILANCIARLI 

QUAL È IL MODO MIGLIORE PER ORDINARE I DATI? E COSA SUCCEDE QUANDO UN DATO 
ENTRA O ESCE DA UNA STRUTTURA ORDINATA? A QUESTA E A MOLTE ALTRE DOMANDE 
DAREMO UNA RISPOSTA IN QUESTO ARTICOLO 



Abbiamo avuto modo di visionare gli alberi 
binari e quelli di ricerca, che molto sin- 
teticamente, per chi ha saltato lo scorso 
numero, rivisiteremo. Ci occuperemo adesso 
dei particolari alberi che godono di una signi- 
ficativa caratteristica che li rende "equilibrati 
ed armoniosi" in un'unico termine: "bilanciati". 
Metteremo le mani nella parte meramente tec- 
nica di manipolazione della struttura, com- 
prendendo al meglio gli strumenti e i metodi 
da usare nelle diverse occasioni. Vedremo che 
adottare alcune tecniche di ottimizzazione con- 
sente di effettuare scansioni realmente rapi- 
dissime. Analizzeremo anche alcuni casi estre- 
mi in cui la presenza di dati particolarmente 
sbilanciati non consente di realizzare struttu- 
re perfette. Ad esempio cosa succede se volete 
ordinare l'alfabeto? si degenera nel caso in cui 
un albero diventa una lista e i metodi che esplo- 
reremo non sono più applicabili. 



un semplice albero binario. 
Un albero è di ricerca se come nella figura i da- 
ti sono sistemati in modo da essere ordinati. Per 
ogni nodo tutte le informazioni contenute nel sot- 
toalbero sinistro sono minori e quelle del sot- 
toalbero destro sono maggiori. La volta scorsa 
abbiamo approntato la strutturazione fisica e 
le principali funzioni di visita, ricerca e inseri- 
mento. Il tutto seguendo le indicazioni della 
OOP (Object oriented programming), ossia la pro- 
grammazione ad oggetti. In C++ è stata costruita 
una classe albero. Ne riporto il prototipo arric- 
chito dei nuovi metodi che prevedono la ge- 
stione degli alberi avl.NelT articolo pubblicato nel 
numero 103 di ioProgrammo abbiamo appun- 
to analizzato nel dettaglio tutti i metodi esposti 
in questo prototipo, eccetto il caso della rimo- 
zione che vedremo in questo numero 

class albero 





CI CD CJ WEB 

i.zip 



ALBERI BINARI 
E DI RICERCA 

Un albero è una struttura dati molto flessibile che 
ci consente di rappresentare molti problemi. 
Con albero nell'ambiente dei programmatori 
si intende di fatto un albero binario. Una strut- 
tura cioè che abbia per ogni elemento (nodo) 
al più due discendenti. In figura 1 è mostrato 




Fig. 1: Albero binario di ricerca 



{ public: alberoQ; 



albero(char*); 



^alberoQ; 



void aggiungi(char*); 



void postordineQ; 



void preordineQ; 



void inordineQ; 



bool ricerca(char*); 



void rimuovi(char*); 



void iterat(); 



int calcolaprofQ; 



bool bilanciatoavlQ; 



private: 



struct nodo { 



char *info; 



nodo *sx; 



nodo *dx; 



}; 



struct nodo *tree; 



int prof; // profondità calcolata con il metodo 

associato; 



nodo* q; 
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nodo* p; 



void agg(nodo* &, char*); 



void postordinepriv(nodo*); 



void preordinepriv(nodo*); 



void inordinepriv(nodo*); 



void cerca(nodo*, char*, bool &); 



void rim(nodo* &, nodo*); 



void elim(nodo* &, char*); 



bool bilanciatoavlpriv(nodo *); 



int profondita(nodo*); 



int maggiore(int,int); 



}; 



Tra i membri pubblici si scorgono le varie fun- 
zioni per effettuare la vista e l'inserimento. Nei 
prossimi paragrafi analizzeremo in modo par- 
ticolareggiato i nuovi componenti. 



puntatore. Bisogna quindi procedere sostituendo 
l'elemento rimosso con il nodo più a destra del 
sottoalbero sinistro o con il nodo più a sinistra 
del sottoalbero destro, entrambi i quali hanno 
al più un discendente. In figura 2 sono riporta- 
ti i tre casi di rimozione. 

Neil' implementare il procedimento si è costruito 
un metodo pubblico rimuovi(char* mess), a ta- 
le proposito si esamini la classe completa di tut- 
ti i suoi membri. Tale metodo usa altre due fun- 
zioni private che attraverso chiamate ricorsive 
implementano la linea di azione prima descritta. 
Vediamo il codice. 

// routine per l'implementazione di rimuovi 

void albero: :rim(nodo* &nod, nodo* nod2) 
{ 



RIMOZIONE DI UHI NODO 

Cominciamo lo studio di un caso oltre che uti- 
le, molto istruttivo. La rimozione di un nodo da 
un albero. In altri termini si vuole cancellare un 
nodo che abbia contenuto informativo uguale 
a quello che specifichiamo come utenti da input, 
e naturalmente lasciare la struttura a forma di 
albero. Va detto che non è un'operazione bana- 
le come l'inserimento di un elemento. Il compito 
è semplice se c'è da rimuovere una foglia. In tal 
caso è sufficiente cancellarla. Anche la cancel- 



if (nod->dx! = 0) rim(nod->dx,nod); 



else 









Fig. 2: Alcuni esempi di cancellazione di nodi da un albero. A albero iniziale. B can- 
cellazione di una foglia. C cancellazione di un nodo con un solo discendente. D 
cancellazione di un nodo intermedio 



lazione di un nodo che abbia un solo discen- 
dente (o destro o sinistro, non importa quale) 
non è difficile. Basta "attaccare" il sottoalbero 
discendente che è unico al posto dell'elemen- 
to da eliminare. I problemi sorgono quando si de- 
ve cancellare un qualsiasi altro nodo diverso da 
quelli prima descritti. Insomma, quando un no- 
do ha due discendenti. Si comprende che è im- 
possibile collegare i due elementi ad un solo 



{ nod2->info=nod->info; 



q = nod; // salvataggio per deleteQ 



nod = nod->sx; 



}; 



// routine per l'implementazione di rimuovi 



void albero: :elim(nodo* &p,char *mess) 
{ if (p= = 0) cout<<"parola non presente\n"; 
else if (strcmp(mess,p->info)<0) elim 

(p->sx,mess); 
else if (strcmp(mess,p->info)>0) elim 

(p->dx,mess); 
else // si esaminano i tre casi 
{ q = p; // salvataggio per delete() 
if (p->dx= = 0) p=p->sx; 
else if (p->sx= = 0) p=p->dx; 
else rim(p->sx,p); 



// metodo pubblico per la rimozione del nodo 

con info mess 
void albero: :rimuovi(char* mess) 
i 

q = Q; 

p=tree; 

elim(p,mess); 

if (q!=Q) delete q; 

}; 



In q ci sarà il nodo da eliminare fisicamente me- 
diante una delete (), che libera opportunamen- 
te la memoria. Mentre p è il puntatore che scan- 
daglia la struttura ed è inizialmente posiziona- 
to sulla radice dell'albero (tree). Con elim si pri- 



► 110 /Luglio 2006 



http://www.ioprogrammo.it 



Metodi di ricerca su alberi AVL ■ T SOLUZIONI 



ma verifica se c'è il messaggio come contenuto 
informativo di un nodo. Fin quando non si tro- 
va si percorre l'albero come per una normale 
ricerca. Una volta trovato l'elemento, se uno dei 
due discendenti è nullo (non a caso oltre che lo 
zero si può usare la parola chiave NULL) si at- 
tacca il sottoalbero non nullo. Non si controlla 
che entrambi i discendenti siano nulli, situa- 
zione che si presenta per una foglia; visto che 
l'azione suddetta funziona anche in questo ca- 
so; semplicemente si attacca non un sottoal- 
bero ma un puntatore nullo. L'ultimo caso si ri- 
solve ricorrendo alla funzione rim. Essa scen- 
de nel ramo più a destra del sottoalbero sini- 
stro e individua il nodo da sostituire. Si assegna 
il contenuto informativo. Al termine delle ope- 
razioni ci si libera con delete () del nodo foglia rag- 
giunto. 



(a\ 


^batè) 




^JOTTO ALBERO 





Fig. 3: Esempio di albero binario di ricerca 
non bilanciato 



ALBERI AVL 

Normalmente la struttura albero non rimane 
invariata durante l'applicazione. Spesso subi- 
sce significative modifiche, usualmente cresce. 
È il caso del problema delle concordanze dove 
un nodo contiene una singola parola e la sua 
occorrenza in un testo; quindi due campi infor- 
mativi. In tal senso nell' analizzare il testo ogni 



CONVIENE BILANCIARE ... 
PERFETTAMENTE! 



Il bilanciamento di un 
albero ha un costo, in 
termini di complessità 
computazionale, 
quindi di tempo. Tale 
costo è molto più 
elevato nel caso del 
perfetto 
bilanciamento. 
Un'analisi presentata 
da N. Wirth ha 
dimostrato che il 
costo che si deve 
sostenere per 
mantenere un albero 



perfettamente 
bilanciato, nella 
maggior parte dei casi 
non viene giustificato 
da una più efficiente 
utilizzo dell'albero 
stesso. Conviene 
perfettamente 
bilanciare solo nei 
casi limiti per i quali 
l'albero degenera in 
liste o in strutture 
"simili" a liste, che 
però sono appunto 
molto improbabili. 



qual volta si incontra una nuova parola si ag- 
giunge un nuovo nodo e si inizializza a uno(l) 
il numero di occorrenze. Se si incontra una pa- 
rola non nuova semplicemente se ne incre- 
mentano le occorrenze. Strutture siffatte sono 
molto comuni nell'ambito della linguistica com- 
putazionale. Si tratta di un esempio significa- 
tivo perché l'albero cresce in modo rapido; è 
quindi importante che sia efficiente. Sarebbe- 
ro non ottimizzate strutture come quella mo- 
strata in figura 3. 

In realtà se non si adottano misure non si può pre- 
vedere come l'albero crescerà. Vi sono dei casi 
limite, che ovviamente hanno bassissime pro- 
babilità di verificarsi per i quali un albero de- 
genera in una lista. Se, infatti tutte le parole che 
in sequenza si analizzano sono strettamente 
crescenti oppure decrescenti vengono appese 
sempre a destra oppure a sinistra. Cosicché, la 
ricerca degenera a complessità n/2 e non log(n) 
come si ci auspicava. Il caso migliore è che l'al- 
bero sia perfettamente bilanciato. Un albero è 
perfettamente bilanciato se per ogni nodo il nu- 
mero di nodi del sottoalbero sinistro e del sot- 
toalbero destro differiscono al più di 1. 
Si tratta di una situazione ideale che per essere 
raggiunta e mantenuta richiede un notevole di- 
spendio di tempo. Nella stragrande maggio- 
ranza dei casi non conviene mantenere un equi- 
librio così rigido della struttura. Per superare 
un bilanciamento così rigido è stato introdotto 
una definizione per cosi dire più flessibile che 
è anche più facile da raggiungere e mantenere. 
Un albero è bilanciato AVL se per ogni nodo le 
profondità dei suoi due sottoalberi differiscono 
al più di uno. Quindi ci si concentra sulla profon- 
dità anziché sul numero di nodi. Tale defini- 
zione è stata formulata dagli studiosi G.M. Adel- 
son Velskii e E.M. Landis, le cui iniziali hanno 
dato il nome agli alberi. Con il termine alberi 
bilanciati si intende di fatto gli alberi bilancia- 
ti AVL. Gli alberi bilanciati sono un sottoinsie- 
me degli alberi perfettamente bilanciati. Come 
vedremo gli AVL oltre che essere distinti da una 
semplice definizione sono associati a semplici 
routine per mantenerne il bilanciamento. Inol- 
tre, è sempre garantita complessità logaritmi- 
ca, anche nel caso peggiore, per operazioni di ri- 
cerca, inserimento e cancellazione. Analizziamo 
qualche altro metodo associato agli alberi AVL. 
Vediamo come si può verificare la caratteristi- 
ca di bilanciamento. 



// routine 


per 1 


'implementa 


zione di 


profondità 




int albero 


:ma 


ggiore(int x, 


inty) 




{ intz; 


if (x>y) 


z=x 
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else z=y; 


return z; 


}; 




// metodo privato di profondita 




int albero: :profondita(n 


odo* nod) 




{ 


if (nod = = 0) prof=0; 


else prof=l + maggiore(profondita(nod- 
profondita(r 


>sx), 
iod->dx)); 


return prof; 


}; 


// metodo pubblico per 


il calcolo della profondità 





int albero: 


:calcolaprof() 


{ return profondita(tree); 


}; 



// metodo privato per la verifica 
// di bilanciamento avi 

bool albero: :bilanciatoavlpriv(nodo* nod) 

S 

bool bilanc; 



if (nod = = 0) bilanc=true; 



else bilanc= ( (abs(profondita(nod->sx) 

profondita(nod->dx))< = l) && 
(bilanciatoavlpriv(nod->sx)) && 

(bilanciatoavlpriv(nod->dx)) ); 

return bilanc; 



ANALIZZATORE SINTATTICO DI ESPRESSIONI 



// metodo pubblico per la verifica 



Un problema molto interessante 
che trova la sua naturale soluzione 
con l'uso di un albero binario è 
l'analizzatore sintattico di 
espressioni matematiche. Data una 
stringa di input che contiene 
l'espressione si vuole generare in 
output il risultato. L'espressione 
può avere un numero qualsiasi di 
parentesi tonde. L'alfabeto che si 
considera, ossia l'insieme dei 
simboli che si possono trattare è: 
{0,1,2,3,4,5,6,7,8,9, *,/,+,-, 
<spazio>, $, (,), }. I simboli sono 
classificabili nei tre insiemi: delle 
cifre, delle operazioni e dei 
caratteri. L'ultimo insieme oltre che 
lo spazio e le parentesi contiene il 
simbolo $ di fine stringa. 
Ovviamente, si trattano solo 
numeri interi. 

La struttura dell'algoritmo di cui 
forniremo le linee generali di 
azione può essere così 
schematizzata: 

- leggi stringa 

- analizza stringa 

- trasforma stringa in albero 

- valuta albero 

- produci output 

Come si può intuire si tratta di un 
piccolo compilatore costituito 
proprio da analizzatore lessicale 
(passo 2) e da parser (passo 4). 
Ovviamente, il tutto è semplificato, 
e non è necessario scomodare tutte 
i costrutti teorici dei compilatori. Il 
singolo nodo come deve essere 
fatto? Dovrà contenere il 
patrimonio informativo e un altro 
campo che specifica a quale 
insieme il simbolo appartiene, visto 
che per ogni insieme di simboli si 
dovrà attuare un diverso 
comportamento. 



Vediamo come un'espressione 
genera un albero; la seguente di 
esempio: 4 + 6-1$ produce l'albero 
di figura 6. 

Si nota ad esempio che 
un'operazione è sempre un nodo e 
che essa non può trovarsi come 
terminale (foglia) altrimenti 
risulterebbe incongruente il calcolo. 




Fig. 6: albero binario associato ad un'e- 
spressione matematica 

Inoltre, si nota come l'espressione 
si ottenga dall'albero con una visita 
simmetrica (in ordine). 
L'analizzatore della stringa dovrà 
sostanzialmente verificare che 
simboli siano effettivamente 
appartenenti all'alfabeto e potrà ad 
esempio eliminare gli spazi che non 
servono per la costruzione. Anche 
la congruenza delle parentesi può 
essere fatta in questa fase. Nella 
trasformazione da stringa ad 
albero, che è un'operazione delicata 
si devono fare inserimenti mirati a 
seconda del tipo di simbolo che si 
incontra. Ad esempio, la semplice 
terna (cifra, operazione, cifra) si 
trasforma in un mini albero (fig 6 
cerchiato in rosso) 



// di bilanciamento avi 



bool albero: :bilanciatoavl() 



{ return bilanciatoavlpriv(tree); 



}; 



Il metodo maggiore semplicemente individua 
il più grande tra due numeri, si tratta di una rou- 
tine di servizio usata da profondita. Questo me- 
todo (l'assenza dell'accento sulla a non è un er- 
rore, i programmatori sanno che à è un carat- 
tere non consentito per gli identificatori) cal- 
cola la profondità. Poiché prende come para- 
metro un nodo, si è preferito renderlo privato 




Fig. 4: Albero binario bilanciato su cui operare un 
inserimento 

e produrre un altro metodo: calcolaprof() che 
sia pubblico. Nella definizione ricorsiva di profon- 
dità si realizza il metodo. La profondità è la som- 
ma tra 1 e la maggiore profondità tra il sottoal- 
bero sinistro e il sottoalbero destro. Le profon- 
dità dei due sottoalberi vengono calcolate ap- 
plicando l'identica definizione. Conoscendo la 
profondità si può facilmente verificare se l'al- 
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bero è bilanciato o meno. Anche in questo caso 
l'assegnazione alla variabile booleana bilanc, 
attraverso riferimenti ricorsivi alla stessa pro- 
cedura, descrive in modo esplicativo il concet- 
to di bilanciamento. 



INSERIMENTO 

IN ALBERI BILANCIATI 

Quando bisogna inserire un nuovo nodo in un 
albero bilanciato (intendiamo sempre AVL) si 
possono presentare tre casi rispetto alle profon- 
dità dei sottoalberi destro e sinistro della radi- 
ce: 

1. le profondità diventano diverse, ma il crite- 
rio di bilanciamento è salvaguardato, 

2. le profondità diventano uguali. C'è un mi- 
glioramento della situazione 

3. le profondità diventano diverse violando il 
criterio. 

Risulta chiaro che bisogna prendere provvedi- 
menti per ristabilire il bilanciamento solo nel 
caso 3. Rispetto all'albero di figura 4, provoca- 
no uno "sbilanciamento" gli inserimenti di no- 
di che verrebbero appesi al nodo 7, negli altri 
casi si mantiene il bilanciamento. 
La condizione di equilibrio è che la differenza tra 
le profondità tra sottoalbero sinistro e destro 
della radice sia -1, o 1. È fondamentale stabi- 
lire il modo di memorizzare tale informazione. 
Si può mantenere tale indice implicito alla strut- 
tura, quindi ricalcolarlo per ogni variazione del- 
la stessa. 

Oppure, esplicito prevedendo spazi nei vari no- 
di per la memorizzazione delle profondità. Il 
primo metodo in caso di strutture molto estese 
richiede un costo computazionale elevato. Il se- 
condo fornisce un maggiore spreco di memo- 
ria ma sicuramente migliora e non di poco le 
prestazioni. 

Questa decisione si prende in fase di progetta- 
zione anche con riferimento al tipo di albero. 
Vediamo nello specifico come si ristabilisce il 
bilanciamento dopo un inserimento del tipo 3. 

I casi limite sono 2 e sono riproposti nella figu- 
ra 5 a. Con la croce si indica il nuovo elemento 
aggiunto che non fa rispettare il criterio di bi- 
lanciamento. Si noti una differenza massima di 
profondità pari a 2. 

II bilanciamento si ottiene mediante operazio- 
ni di rotazione. La rotazione singola (caso 1), 
che sia destra o sinistra non fa differenza, ef- 
fettua spostamenti verticali dei nodi, in oriz- 
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zontale essi mantengono sempre la stessa po- 
sizione. Anche la doppia rotazione (caso 2) ri- 
stabilisce il bilanciamento con spostamenti ver- 
ticali. 



CONCLUSIONI 

Capire i metodi elementari di manipolazioni di 
strutture come gli alberi bilanciati AVL è un im- 
portante patrimonio per il programmatore, che 
può spendere queste abilità per la risoluzione di 
un'ampia casistica di applicazioni che richie- 
dono l'uso di alberi. 

Per quanto gli strumenti di programmazione 
moderna, nascondano il più delle volte la com- 
plessità di questo genere di algoritmi, tuttavia nel- 
la programmazione tradizionale è importante ri- 
conoscere come certi metodi vengano applica- 
ti. In caso di necessità di ottimizzazione, esse- 
re in grado di scrivere un algoritmo di ricerca 
binaria su alberi bilanciati diventa spesso Tu- 
nica via d'uscita. 

Fabio Grimaldi 
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Fig. 5: Bilanciamento di alberi per rotazione 



http://www.ioprogrammo.it 



Luglio 2006/ 113 ► 



